从 去 年 开始 ，“ 区 块 链 ” 成 了 一 个 高 热度 的 关键 字 ， 受 到 各 行 各 业 的 关注 。 越 来 越 多 的 人 渴望 用 区 块 链 这 一 变革 性 技术 来 解 
决 商业 中 的 关键 问题 。 自 然 ， 有 更 多 的 人 渴望 深入 了 解 和 运用 区 块 链 技术 甚至 开发 自己 的 区 块 链 应 用 。 最 近 一 年 多 ， 总 是 有 很 多 
朋友 和 学 生 问 我 : “如 何 学 习 以 大 坊 ? 有 什么 资料 推荐 吗 ? ”通常 我 的 回答 就 是 : “从 以 太 坊 白皮书 和 黄皮书 看 起 吧 。 XA, 
仅仅 精读 两 篇 文章 是 不 够 的 ， 要 想 对 区 块 链 有 进一步 的 认识 ， 还 需要 更 多 的 知识 储备 。 但 是 目前 国内 很 难 找 到 一 本 系统 介绍 区 块 
链 技 术 和 开发 平台 的 书籍 。 作 为 在 区 块 链 领 域 具 有 较 高 知名 度 和 丰富 从 业经 验 的 专家 团队 ， 我 们 非常 希望 能 给 大 家 提供 一 套 系 统 
的 学 习 资 料 。 


作为 这 场 区 块 链 技 术 热 潮 的 弄潮儿 ， 以 太 坊 是 最 先进 区 块 链 技术 的 代表 。 以 太 坊 的 社区 和 开发 工具 都 相对 比较 完善 和 活跃 。 
正 因 如 此 ,很 多 企业 级 区 块 链 解决 方案 都 在 积极 地 拥抱 以 太 坊 。 但 是 很 送 居 ， 系 统 介 绍 以 太 坊 的 中 文 资料 非常 太 达 。 首 次 接触 到 
E 度 上 难得 的 技术 资料 ， 于 是 想 尽快 呈现 给 国内 的 
读者 。 在 翻译 过 程 中 ， 我 们 在 保证 表述 流畅 的 同时 ， 对 原著 的 内 容 进 行 了 验证 ， 并 对 其 中 的 错误 进行 了 修正 。 因 此 ， 本 书 应 该 比 
英文 原版 书 更 加 易 懂 和 准确 。 


在 本 书 中 ， 读 者 将 了 解 如 何 编 写 智 能 合约 、 如 何 用 JavaSctipt 开 发 以 太 坊 程序 ， 以 及 如 何 为 区 块 链 创 建 端 到 端 应 用 。 
本 书 具 有 如 下 特点 : 
“学生 导向 ” ， 跟 着 这 术 书 可 以 由 浅 及 深 地 学 习 以 太 坊 技术 应 用 
` 给 出 了 多 个 真实 的 以 太 坊 智能 合约 编写 示例 ， 可 帮助 初学 者 迅速 上 手 编写 代码 。 
` 通俗 易 懂 ， 讲 解 细致 ， 方 便 自 学 。 


在 翻译 本 书 的 同时 ， 我 们 的 团队 没有 停止 前 进 的 脚步 。 我 们 不 断 努 力 ， 以 求 在 技术 深度 上 更 进一步 。 读 者 掌握 本 书 的 内 容 
后 ， 可 以 阅读 我 们 即将 于 近期 出 版 的 其 他 关于 以 太 坊 和 Hyperledget 的 书 ， 以 加 深 对 区 块 链 的 关键 技术 的 认识 。 详 情 请 见 我 们 的 微 


信 公 众 号 “ 智 链 ChainNova”。 


区 块 链 是 一 个 防 甘 改 的 去 中 心 化 账本 ， 其 中 包含 不 断 增长 的 数据 记录 列表 。 每 个 用 户 都 可 以 连接 到 网 络 ， 发 送 新 的 交易 、 验 


证 交易 和 创建 新 的 区 块 。 

本 书 将 益 释 区 块 链 的 概念 ， 讲 述 其 如 何 保 证 数据 真实 性 ， 以 及 如 何 使 用 以 太 坊 创建 现实 世界 的 区 块 链 项 目 。 通 过 有 趣 的 现实 
世界 案例 ， 读 者 将 了 解 如 何 编写 完全 按照 程序 运行 、 没 有 次 诈 、 没 有 中 心机 构 或 者 第 三 方 干预 的 智能 合约 ， 并 学 习 如 何 创建 端 到 
端的 区 块 链 应 用 。 本 书 还 将 介绍 加 密 货币 中 的 密码 学 、 以 太 币 安 全 、 挖 矿 、 智 能 合约 和 Solidity 等 概念 。 


区 块 链 是 比特 币 中 最 有 创造 性 的 技术 ， 是 记录 比特 币 交 易 的 公共 账本 。 


第 1 章 阐 释 DApp 的 概念 ， 并 简 述 其 工作 原理 。 

第 2 章 阐 释 以 太 坊 的 工作 原理 。 

第 3 草 阐 释 如 何 编 写 智能 合约 和 使 用 geth 交 互 接口 来 部 闭合 约 ， 以 及 使 用 web3.js 广 播 交 易 。 

第 4 章 介 绍 web.3js 的 概念 及 其 导入 方法 、 连 接 到 geth 的 方法 ， 并 阐释 了 如 何在 node.js 或 者 客户 端 JavaScript 使 用 它 。 


第 5 章 阐 释 如 何 创 建 钱包 服务 ， 以 方便 用 户 创 建 和 管理 以 太 坊 钱包 ， 其 至 离线 创建 和 管理 钱包 。 我 们 将 专门 使 用 LightWallet 


库 实 现 。 
第 6 章 展示 如 何 使 用 web3.js 编 译 智 能 合约 ， 以 及 使 用 web3.js 和 Ethereum]JS 部 署 智能 合约 。 


第 7 章 曾 释 如 何 使 用 Oraclize 从 以 太 坊 智能 合约 发 出 HTTP 请 求 ， 以 访问 万 维 网 中 的 数据 。 我 们 还 将 学 习 访 问 存 储 在 IPFS 中 的 
文件 、 使 用 字符 串 库 处 理 字符 串 等 方法 。 


第 8 章 阅 释 如 何 使 用 truffle。truffle 将 使 创建 企业 级 DApp 交 得 容易 。 我 们 将 通过 创建 代 币 来 学 习 truffle。 
第 9 章 阐 释 创 建 联盟 区 块 链 的 方法 。 

设备 环境 
Windows 7 SP1+. Windows 8. Windows 10 或 者 Mac OS X 10.84, 

LAIR 


本 书 适合 想 使 用 区 块 链 和 以 太 坊 创 建 防 纂 改 数据 (和 交易 ) 应 用 的 JavaScript 开 发 人 员 阅 读 ， 也 适合 对 密码 学 及 其 逻辑 以 及 相 
关 数 据 库 感 兴趣 的 人 阅读 。 


下 载 实例 代码 


可 以 从 http://www.packtpub.com 下 载 本 书 的 实例 代码 文件 。 如 果 您 在 其 他 地 方 购买 了 本 书 ， 可 以 访 
J http: //www.hzbook.comiz Ht FF F Ro 


Sle ”去 中 心 化 应 用 


我 们 以 前 用 过 的 所 有 互联 网 应 用 几乎 都 是 中 心 化 的 ， 即 每 个 应 用 的 服务 端 由 一 个 特定 企业 或 个 人 所 有 。 长 期 以 来 ， 开 友人 员 
创建 中 心 化 应 用 ， 用 户 使 用 中 心 化 应 用 。 但 是 中 心 化 应 用 存在 一 些 问 题 ， 包 括 不 透明 、 有 单 点 故障 、 不 能 防止 网 络 审查 等 ， 导 致 
几乎 不 可 能 创建 菏 些 特定 类 型 的 应 用 。 为 了 解决 这 些 问题 ， 一 项 新 的 技术 诞生 了 ， 它 创建 以 网 络 为 基础 的 去 中 心 化 应 用 

(DApp) 。 在 本 章 中 ， 我 们 将 学 习 去 中 心 化 应 用 。 


在 本 章 中， 我们 将 讲解 以 下 内 容 : 


` 什么 是 DApp。 

“ 去 中 心 化 、 中 心 化 和 分 布 式 应 用 之 间 的 区 别 。 

-中心 化 和 去 中 心 化 应 用 的 优 点 和 缺点 。 

. 概述 一 些 最 热门 的 DApp 所 使 用 的 数据 结构 、 算 法 和 协议 。 


学 习 一 些 创 建 在 其 他 DApp 之 上 的 流行 DApp。 


1.1 什么 是 DApp 


DApp 是 一 种 互联 网 应 用 ， 其 后 端 在 去 中 心 化 的 点 对 点 网 络 上 运行 ， 且 其 源 代 码 是 开源 的 。 网 络 中 不 存在 能 够 完全 控制 
DApp 的 节点 . 


根据 DApp 的 功能 不 同 ， 使 用 不 同 的 数据 结构 来 存储 应 用 数据 。 例 如 ， 比 特 币 DApp 使 用 区 块 链 数据 结构 。 


这 些 对 等 节点 (peer) 可 以 是 网 络 中 的 任何 计算 节点 ， 因 此 ， 友 现 和 防止 节 点 对 应 用 数据 进行 非法 复 改 或 者 与 其 他 人 分 享 
错误 信息 是 一 个 重要 挑战 ， 所 以 需要 对 等 节点 之 间 有 一 些 关 于 某 个 书 点 友 布 的 数据 是 否 正确 的 共识 。 在 DApp 中 ， 没 有 一 个 中 心 
服务 器 来 协调 书 点 ， 或 者 决定 什么 是 对 、 什 么 是 错 ， 因 此 应 对 这 个 挑战 确实 不 容易 。 一 致 性 协议 (concensus protocol) 可 用 
于 解决 这 个 问题 。 不 同 的 DApp 通 常 使 用 不 同 数据 结构 类 型 的 共识 协议 ， 例 如 比特 币 使 用 工作 量 证 明 协 议 (POW) 来 达成 共识 。 


为 了 让 用 户 () 使 用 DApp， 每 一 个 DApp 都 需要 一 个 客户 端 (client) 。 使 用 DApp 时 ， 用 户 首先 需要 运行 DApp 中 自己 的 
节 扎 服务 端 ， 然 后 将 客 尸 端 连接 至 节点 服务 辣 。DApp 的 节点 只 提供 应 用 程序 编程 接口 (Application Programming 
Interface, API) ， 并 允许 开发 者 社区 使 用 API 开 发 多 种 客户 端 。 一 些 DApp 开 发 人 员 会 提供 一 个 官方 的 客户 端 。DApp 客 户 端 应 
该 是 开源 的 ， 并 可 以 被 下 载 使 用 ， 否 则 整个 去 中 心 化 的 想法 就 失败 了 。 


但 是 建立 客 尸 尊 架 构 比 较 麻 烦 ， 如 果 用 户 不 是 开 友 人 员 ， 束 更 麻烦 。 因 此 ， 客 己 端 通 弟 作为 服务 和 /或 匡 点 形式 出 现 ， 以 便 
让 使 用 DApp 的 过 程 更 容易 。 
à, eonim 


分 布 式 应 用 是 指 应 用 分 布 在 多 个 服务 端 上 ， 而 非 只 有 一 个 服务 端 。 当 应 用 数据 和 通信 量变 得 巨大 ， 且 应 用 的 停机 时 间 难 以 承 
受 时 ， 分 布 式 是 必要 的 。 在 分 布 式 应 用 中 ， 数 据 在 多 个 服务 端 中 备份 ， 以 具有 较 高 可 用 性 。 中 心 化 应 用 可 能 是 分 布 式 的 ， 也 可 能 
不 是 分 布 式 的 ， 但 去 中 心 化 应 用 肯定 是 分 布 式 的 。 例 如 Google、Facebook、Slack、DropBox 等 是 分 布 式 的 ， 而 简单 的 投资 组 合 网 


站 或 者 个 人 微 博通 常 不 是 分 布 式 的 ， 除 非 通信 量 很 大 。 


1.1.1. 去 中 心 化 应 用 的 优点 


中 心 化 应 用 的 一 些 优点 如 下 : 


: DApp 能 容错 ， 没 有 单 点 故障 ， 因 为 它们 默认 是 分 布 式 的 。 


防止 菜单 一 


机 构 的 干扰 。 因 为 没有 一 个 中 心机 构 ， 任 何 第 三 方 机 构 无 法 向 中 心机 构 施 压 允 连 其 删除 一 些 内 容 。 甚 至 没有 单 
一 机 构 能 关闭 应 用 的 域名 或 者 IP 地 址 ， 因 为 DApp 不 是 通过 一 个 特定 的 IP 地 址 或 者 域名 访问 的 。 或 许 菜 些 机 本 
网 络 中 的 单个 节点 并 关闭 它 ， 但 是 如 果 网 络 很 庞大 ， 则 几乎 不 可 能 关闭 应 用 


以 通过 IP 地 址 追 
用 户 容 易 相 信 该 应 用 。 因 为 它 不 是 由 


欺骗 用 户 来 年 利 的 机 构 所 控制 的 


1.3.2. 去 中 心 化 应 用 的 号 后 


显然 ， 每 个 系统 都 不 是 完美 的 。 去 中 心 化 应 用 的 一 些 缺 点 如 下 


: 修改 bug 或 者 更 新 DApp 很 困难 ， 因 为 网 络 中 的 每 一 个 节点 都 需要 更 新 其 节点 软件 。 
一 些 应 用 要 求 验证 用 户 身 份 ( 即 KYC) 


却 没 有 中 心 化 的 机 构 来 验证 用 户 身份 ， 开 发 应 用 时 会 遇 到 问题 。 
建 去 中 心 化 应 用 比较 困难 ， 因 为 它们 应 用 复杂 的 协议 达成 共识 ， 且 必须 从 最 开始 就 自行 创建 并 扩大 规模 。 所 以 我 们 不 
仅仅 实现 一 个 想法 ， 然 后 不 断 添加 功能 ， 使 其 规模 扩大 


- 应 用 通常 独立 于 第 三 方 APL， 


以 获取 或 者 存储 数据 。DApp 不 能 依赖 中 心 化 应 用 API， 但 
DApp 的 生态 圈 还 不 太 大 ， 所 以 创建 起 来 比较 困难 。 
XE. 


可 以 依赖 其 他 DApp。 因 为 目前 
尽管 DApp 理 论 上 可 以 依赖 其 他 DApp， 但 在 实践 中 紧 锅 融合 DApp 仍 比较 困 


1.2 ”去 中 心 化 目 治 


HZH 


一 般 来 说 ， 被 签署 的 文件 可 以 代表 组 织 ， 而 且 政 府 能 对 它们 产生 影响 。 根 据 组 
股 乐 。 


织 类 


型 的 不 同 ， 组 织 可 能 有 股东 ， 也 可 能 没有 
KAMLA R? 


写 明 的 规则 运行 


15171 


日 织 (Decentralized Autonomous Organization, DAO) 是 由 计算 机 程序 代表 的 组 织 ( 即 组 织 根据 程序 中 
) ， 完 全 透明 ， 完 全 由 股 世 控制， 不 受 政府 影响 。 


为 了 达到 这 些 目标 ， 我 们 需要 把 DAO 作 为 DApp 来 开 友 。 因 此 ， 我 们 可 以 说 DAO 是 DApp 的 一 个 子 类 。 
Dash 和 DAC 是 DAO 的 一 些 例子 。 


1 sa] (DAC) ? 


DAC 和 DAGO 尚 无 很 明显 的 差别 。 很 多 人 认为 它们 是 一 样 的 ， 有些 人 则 在 DAO 为 股东 谋取 利益 时 将 DAC 定 义 为 DAO 


1.3 DApp 中 的 用 户 身 份 


DApp 的 主要 优点 之 一 是 它 一 般 能 保证 用 户 的 匿名 性 ， 但 是 许多 应 用 要 求 用 户 必 须 经 过 身份 验证 这 个 过 程 才能 使 用 应 用 。 
为 DApp 中 没有 中 央 机 构 ， 验 证 用 户 身份 成 了 一 个 挑战 。 


在 中 心 化 应 用 中 ， 人 们 要 求 用 户 提交 特定 的 扫描 文件 、OTP 验 证 等 ， 再 验证 用 户 身份 。 该 过 程 称 为 Know Your 
Customer (KYC) 。 但 是 由 于 DApp 中 没有 人 负责 验证 用 户 身份 ， 所 以 DApp 不 得 不 目 己 验证 用 户 身 份 。DApp 显 然 不 能 理解 和 
验证 扫描 文档 ， 也 不 能 上 友 送 矶 信 ， 因 此 需要 用 户 提供 那些 它们 可 以 理解 和 验证 的 数字 标识 。 主 要 问题 是 几乎 没有 DApp 有 数字 身 
份 ， 只 有 少数 人 知道 如 何 得 到 数字 身份 。 


数字 身份 有 多 种 形式 。 目 前 最 受 推崇 、 最 热门 的 形式 就 是 数字 证 书 。 数 字 证 书 (也 称 为 公 钥 证 书 或 者 标识 证 书 ) 是 一 个 用 来 
证 明 公 钥 所 有 权 的 电子 文档 。 基 本 上 ， 一 个 用 户 拥 有 私 钥 (private key) . 248 (public key) 和 数字 证 书 (digital 
certificate) 。 私 钥 是 秘密 的 ， 用 户 不 应 当 与 其 他 人 分 享 ; 公 钥 可 以 与 其 他 人 分 享 ; 数字 证 书包 含 公 钥 和 谁 拥有 公 钥 的 信息 。 显 
然 ， 生 产 这 种 证 书 并 不 难 ， 因 此 数字 证 书 总 是 由 用 户 可 以 信任 的 授权 机 关 颁 发 。 数 字 证 书 有 一 个 加 密 部 分 是 用 证 书 颁发 机 构 

(certificate authority) 的 私 钥 加 密 的 。 为 了 验证 证 书 的 真实 性 ,我 们 只 需要 使 用 证 书 颁 友 机 构 的 公 钥 解码 该 部 分 ， 如 果 成 功 
解码 ， 那 么 证 书 就 是 合法 的 。 


即使 用 己 成 功 获得 了 数字 身份 并 得 到 DApp 验 证 ， 还 是 有 一 个 关键 问题 ， 那 束 是 有 各 种 各 样 的 数字 证 书 颁 友 机 构 。 为 了 验证 
一 个 数字 证 书 ， 我 们 需要 该 证 书 颁发 机 构 的 公 钥 。 擎 握 所 有 证 书 颁 发 机 构 的 公 和 钥 、 更 新 /添加 新 的 证 书 颁 友 机 构 的 公 钥 是 很 困难 
的 。 因 此 ， 数 字 身 份 验证 程序 通常 在 客 尸 端 里 ， 这 样 可 以 方便 更 新 。 但 仪 把 验证 程序 转移 到 客 尸 端 并 不 能 彻底 解决 问题 ， 因 为 有 
很 多 颁 友 数字 证 书 的 机 构 ， 跟 踪 所 有 机 构 并 把 它们 加 到 客 尸 端 是 很 奈 烦 的 。 


e 为 什么 用 户 不 验证 彼此 的 身份 ? 


在 现实 生活 中 ， 用 户 做 交易 时 ， 通 常会 自己 验证 对 方 的 身份 或 者 可 以 请 一 个 机 构 来 验证 身份 ， 这 个 想法 也 可 以 应 用 到 DApp 
中 。 在 进行 交易 之 前 ， 用 户 可 以 手动 验证 彼此 的 身份 ， 这 个 想法 适用 于 人 们 彼此 进行 交易 的 DApp。 假 设 有 一 个 DApp 是 去 中 心 化 
的 社交 网 络 ， 显 然 可 以 通过 这 种 方式 验证 身份 信息 。 假 设 一 个 DApp 是 用 来 买卖 商品 的 ， 在 支付 之 前 买卖 双方 可 以 验证 彼此 的 身 
份 ， 尽 管 这 个 想法 看 起 来 是 可 行 的 ， 但 是 在 实践 中 很 难 实 现 ， 因 为 你 可 能 并 不 想 每 次 进行 交易 的 时 候 都 验证 身份 ， 也 不 是 每 个 人 
都 知道 如 何 验 证 身份 。 例 如 ， 假设 有 一 个 DApp 是 打车 软件 ， 用 户 显 然 不 想 每 次 叫 出 租车 之 前 都 进行 身份 验证 。 但 如 果 只 是 偶尔 


交易 ， 也 知道 怎样 验证 身份 ， 就 可 以 按 程序 验证 身份 。 


由 于 这 些 原因 ， 我 们 目前 剩 下 的 可 选择 方案 是 ， 由 提供 客户 端的 公司 派 人 手动 验证 用 户 身份 。 例 如 ， 创 建 一 个 比特 币 账 户 不 
需要 身份 证 明 ， 但 是 当 提 取 比 特 币 并 兄 换 成 货币 时 ， 交 易 所 会 要 求 提 供 身 份 证 明 。 客 尸 端 可 以 忽略 未 经 验证 的 用 尸 ， 不 让 他 们 使 
用 ， 也 可 以 对 已 经 身份 验证 的 用 尸 开 放 使 用 。 这 个 解决 办 法 也 会 产生 一 些小 问题 ， 即 如 果 转 换 客 尸 端 ， 会 友 现 交互 的 用 户 不 一 样 
了 ， 因 为 不 同 的 客户 端 有 不 同 的 验证 用 户 集 。 因 此 ， 所 有 用 户 可 能 决定 只 使 用 一 个 特定 客户 端 。 但 这 不 是 一 个 很 大 的 问题 ， 因 为 
如 果 客 户 疹 不 能 有 效 验证 用 户 ， 用 户 融 可 以 方便 地 转 癌 另 一 个 客户 端 ， 而 且 不 丢失 天 键 数据 ， 因 为 天 键 数据 的 仓储 是 去 中 心 化 
的 。 


Q 在 应 用 中 验证 用 户 身 份 的 想法 是 ， 使 用 户 在 进行 一 些 坎 诈 行为 之 后 难以 逃脱 ， 防 止 有 坎 诈 /犯罪 背景 的 用 户 使 用 应 
用 ， 以 及 为 网 络 中 的 其 他 用 户 提供 相信 某 个 用 户 就 是 他 自称 的 人 的 方法 。 用 什么 过 程 来 验证 用 户 身 份 并 不 重要 ， 用 户 总 有 办 法 伪 
装 成 其 他 人 ; 用 数字 身份 或 者 用 扫描 文件 进行 验证 并 不 重要 ， 因 为 二 者 都 可 能 被 盗 或 者 被 重复 使 用 。 重 要 的 是 让 用 户 难 以 伪装 成 
其 他 人 ， 并 收集 足够 的 数据 追踪 用 户 ， 证 明 该 用 户 进行 了 一 些 坎 诈 行为 。 


1.4 DApp 中 的 用 户 账 户 


许多 应 用 需要 用 户 账 尸 功能 。 与 账 己 相关 的 数据 只 能 由 账 己 所 有 者 进行 修改 。DApp 和 中 心 化 应 用 不 一 样 ，DApp 没 有 以 用 
尸 名 和 以 密码 为 基础 的 账 尸 功能， 因为 密码 不 能 证 明 账 尸 中 的 数据 变化 是 由 账户 所 有 者 友 出 的 请 求 导 致 的 。 


有 多 种 方法 能 实现 DApp 中 的 用 户 账 己 ， 最 热门 的 方式 是 使 用 公 和 钥 - 私 钥 对 (public-private key pair) 来 代表 一 个 账户 。 公 
钥 的 哈 希 (hash) 是 账户 的 唯一 身份 。 为 了 改变 账户 中 的 数据 ， 用 户 需 要 用 私 钥 签 名 。 我 们 假设 用 户 会 安全 地 存储 私 钥 。 如 果 
用 户 丢 失 私 钥 ， 束 永远 不 能 访问 账户 了 。 


1.5 ”访问 中 心 化 应 用 


DApp 不 能 依赖 于 中 心 化 应 用 ， 原 因 是 存在 单 点 故障 。 但 是 在 一 些 情况 下 ， 并 无 其 他 办 法 。 例 如 ， 如 果 DApp 想 读 取 一 场 足 
球 比赛 的 成 绩 ， 它 从 哪里 得 到 数据 呢 ” 尽管 DApp 可 以 依赖 另 一 个 DApp， 但 是 国际 足 联 (FIFA) 为 什么 要 创建 一 个 DApp 呢 ? 
际 足 联 不 会 仅仅 因为 其 他 DApp 想 要 数据 ， 束 创建 一 个 提供 成 绩 却 没 有 回报 的 DApp。 


所 以 在 一 些 情况 下 ，DApp 需 要 从 中 心 化 应 用 中 抓 取 数据 。 但 主要 问题 是 DApp 如 何 知 道 从 一 个 域名 中 抓 取 的 数据 有 没有 被 
中 | 则 人 算 改 ， 数 据 是 否 还 是 真实 的 响应 ? 根据 DApp 架 构 的 不 同 ， 解 决 办 法 也 有 所 不 同 。 例 如 在 以 太 坊 中 ， 智 能 合约 不 能 直接 发 
出 HTTP 请 求 ， 为 了 访问 中 心 化 API， 可 以 使 用 Oraclize 服 务 作 为 中 间 人 。Oraclize 为 从 中 心 化 服务 智能 合约 中 抓 取 的 数据 提供 
TLSNotary 验 证 。 


1.6 DApp 中 的 内 部 货币 


中 心 化 应 用 的 所 有 者 需要 盈利 才能 长 期 维护 应 用 的 运行 。DApp 虽 然 没 有 所 有 者 ， 但 是 和 中 心 化 应 用 一 样 ，DApp 节 点 需 
要 硬件 和 网 络 资 源 才能 维持 运行 。DApp 节 点 需要 一 些 有 用 的 回报 来 维持 运行 ， 于 是 内 部 货币 登场 了 。 大 多 数 DApp 都 有 内 置 内 
部 贷 币 ， 或 者 可 以 说 最 成 功 的 DApp 都 有 内 置 内 部 货币 。 


共识 协议 决定 古 点 收取 多 少 内 部 货币 。 根 据 共识 协议 ， 只 有 为 维护 DApp 安 全 和 运行 做 出 贡献 的 那些 特定 书 点 可 以 赚 取信 
币 ， 只 进行 数据 读 取 的 节点 没有 回报 。 例 如 在 比特 币 中 ， 只 有 矿工 (miner) 成 功 挖 矿 才能 赚 取 比特 币 。 


最 大 的 问题 是 ， 这 是 一 种 数字 货币 ， 为 什么 人 们 帝 得 它 有 价值 ?根据 经 济 学 原理 ， 有 供需 差 残 有 价值 。 


让 用 己 用 内 部 货币 付费 才能 使 用 DApp 解 决 了 需求 问题 。 随 着 越 来 越 多 的 用 尸 使 用 DApp， 且 需求 不 断 增长 ， 内 部 货币 的 价 
值 也 升 高 了 。 


货币 总 量 恒定 会 使 货币 变 得 稀缺 ， 从 而 使 其 价值 更 局 。 


货币 是 不 断 供应 的 ， 而 非 一 次 性 供应 所 有 货币 。 正 因 如 此 ， 新 进入 网 络 、 使 网 络 安全 运行 的 节点 也 能 赚 取 货币 。 


DApp 中 内 部 货币 的 缺点 


DApp 有 内 部 货币 的 唯一 缺点 是 ，DApp 不 能 再 免费 使 用 了 。 免 费 是 中 心 化 应 用 占 上 风 的 原因 之 一 ， 因 为 中 心 化 应 用 可 以 用 
广告 赚钱 ， 为 第 三 方 应 用 提供 优质 API， 所 以 可 以 对 用 户 免 费 。 


在 DApp 中 不 能 加 入 广告 ， 因 为 没有 人 去 检查 广告 尺度 ;客户 端 还 可 能 不 展示 广告 ， 因 为 展示 广告 对 他 们 没有 好 处 。 


1.7 什么 是 授权 的 DApp 


到 目前 为 止 , 我 们 学 习 了 完全 开放 的 免 权 限 DApp， 即 任何 人 都 不 需要 建立 身份 束 可 以 参与 。 


男 一 方面 ,授权 的 DApp 并 不 对 所 有 人 开放 。 授 权 的 DApp 继 承 了 免 权限 DApp 的 全 部 属性 ， 但 需要 权限 才能 参与 到 网 络 中 
去 。 各 种 授权 的 DApp 用 到 的 权限 系统 不 同 。 


要 加 入 一 个 授权 的 Dapp 残 需要 权限 ， 免 权限 DApp 的 共识 协议 可 能 在 授权 的 DApp 中 并 不 好 用 ， 因 此 授权 的 Dapp 与 免 权 限 
Dapp 的 共识 协议 是 不 同 的 。 授 权 的 DApp 没 有 内 部 货币 。 


1.8 热门 的 DApp 


现在 我 们 已 经 掌握 了 一 些 关 于 DApp 是 什么 、 它 与 中 心 化 应 用 有 何 区 别 等 知识 ， 让 我 们 探索 一 些 热门 的 、 有 用 的 DApp。 学 
习 这 些 DApp 时 ， 我 们 只 要 达到 理解 其 工作 原理 和 它们 如 何 处 理 不 同 问题 的 程度 丈 够 了 ， 不 用 学 得 太 深 。 


1.8.1 比特 币 

比特 币 (bitcoin) 是 一 种 去 中 心 化 的 货币 ， 是 最 热门 的 DApp。 它 的 成 功 展示 了 Dapp 有 和 多么 强大 ， 并 鼓励 人 们 创建 其 他 
DApp。 在 了 解 比特 币 的 细节 以 及 为 什么 人 们 认为 它 是 一 种 货币 之 前 ,需要 账本 和 区 块 链 的 概念 。 

1. 什 么 是 账本 


账本 (ledger) 本 质 上 是 一 个 交易 列表 。 数 据 库 与 账本 不 同 。 在 账本 中 ， 我 们 只 能 添加 新 的 交易 ; 在 数据 库 中 ， 我 们 可 以 添 
加 、 修 改 和 删除 交易 。 数 据 库 可 以 用 来 实现 账本 。 


2. 什 么 是 区 块 链 


区 块 链 (blockchain) 是 用 于 创建 去 中 心 化 账本 的 数据 结构 。 区 块 链 中 的 区 块 按 序号 排列 。 区 块 包含 一 系列 交易 、 前 一 个 
区 块 的 哈 希 (hash) 、 时 间 戳 (timestamp， 表 明 区 块 的 创建 时 间 ) 、 区 块 回报 (blockreward) 、 区 块 序号 (block 
number) 等 。 每 一 个 区 块 包含 前 一 个 区 块 的 哈 希 ， 由 此 创建 了 区 块 彼此 相连 的 链 。 网 络 中 的 每 一 个 节点 都 保留 区 块 链 的 一 个 备 
bs 


工作 量 证 明 (proof-of-work) 和 权益 证 明 (proof-of-stake) 等 是 用 于 保障 区 块 链 安全 性 的 多 种 共识 协议 。 由 于 共识 协议 
不 同 ， 创 建 区 块 和 添加 区 块 到 区 块 链 中 的 方式 也 不 同 。 在 工作 量 证 明 中 ， 通 过 挖 矿 创建 区 块 ， 这 让 区 块 链 保持 安全 。 在 工作 量 证 


明 协 议 中 ， 控 矿 涉及 解决 复杂 问题 。 我 们 将 在 后 面 学 习 更 多 关于 区 块 链 及 其 共识 协议 的 内 容 。 

比特 币 网 络 中 的 区 块 链 包含 比特 币 交 易 。 网 络 向 成 功 挖 出 区 块 的 书 点 奖励 新 的 比特 币 。 

Qo 区 块 链 数 据 结构 的 主要 优点 是 ， 它 目 动 进行 审计 ， 并 使 应 用 安全 透明 ， 可 以 防止 欺 许 和 贪污 。 根 据 实 现 和 使 用 方式 的 
不 同 ， 它 还 可 以 用 来 解决 许多 其 他 问题 。 

3. 比 特 币 合法 吗 

首先 ， 比 特 币 不 是 一 种 内 部 货币 ， 而 是 一 种 去 中 心 化 的 货币 。 内 部 贷 币 大 部 分 都 是 合法 的 ， 因 为 它们 有 人 资产 且 用 途 明确 。 


主要 问题 在 于 纯 贷 币 DApp 是 否 合 法 。 人 简要 回答 就 是 ,许多 国家 认为 它 是 合法 的 ， 少 数 国家 认为 它 是 非法 的 ， 大 部 分 国家 对 
此 还 没有 做 出 决定 。 


为 什么 少数 国家 认定 它 是 非法 的 ， 大 部 分 国家 对 此 还 没有 做 出 决定 呢 ? 原因 如 下 : 
- 由 于 DApp 中 的 标识 问题 ， 用 户 账户 没有 任何 标识 将 它们 与 比特 币 挂 钧 ， 因 此 ， 它 可 用 于 洗钱 。 
` 这 些 虚 拟 货币 不 稳定 ， 所 以 人 们 丢 钱 的 风险 很 高 。 
- 用 座 拟 货币 很 容易 逃税 。 
4. 为 什么 使 用 比特 币 
比特 币 网 络 仅 用 于 发 送 /接收 比特 币 ， 没 有 其 他 用 途 。 所 以 你 一 定 在 奇怪 ， 人 们 为 什么 对 比特 币 有 需求 ? 
使 用 比特 币 的 原因 如 下 : 
- 可 以 在 世界 上 任何 地 方 快速 便捷 地 发 送 和 接收 支付 。 
- 比特 币 交 易 费 低 于 在 线 支付 交易 党 。 


` 黑客 可 以 从 商户 那里 窃取 支付 信息 ,但 是 在 使 用 比特 币 的 情况 下 ， 鲫 取 比 特 币 地 址 是 完全 没 用 的 ， 因 为 为 了 让 交易 合法 ， 
必须 用 相关 私 钥 签名 ， 而 用 户 在 支付 时 不 需要 和 任何 人 分 享 私 钥 。 


1.8.2 ANJ 


以 太 坊 (ethereum) 是 一 个 去 中 心 化 平台 ， 可 以 在 其 上 运行 使 用 智能 合约 编写 的 DApp。 一 个 或 多 个 智能 合约 可 以 一 起 构 
建 DApp。 以 太 坊 智能 合约 是 在 以 太 坊 上 运行 的 程序 。 智 能 合约 完全 按照 程序 运行 ， 杜 绝 了 停机 、 中 心 化 操控 、 欺 诈 和 第 三 方 干 
涉 的 可 能 性 。 


使 用 以 太 坊 运行 智能 合约 的 主要 优点 是 方便 智能 合约 彼此 交互 ， 而 且 不 需要 担心 整合 共识 协议 等 事情 ， 只 需 编写 应 用 所 需 逻 
辑 即 可 。 当 然 ， 不 能 用 以 太 坊 创建 所 有 种 类 的 DApp， 只 能 创建 以 太 坊 支持 其 功能 的 那些 DApp。 


以 太 坊 有 一 种 内 部 货币 叫 作 以 太 币 (ether 。 部 署 智能 合约 或 者 执行 智能 合约 消 数 需要 用 到 以 太 币 。 


本 书 将 使 用 以 太 坊 创 建 DApp， 并 深入 介绍 以 太 坊 的 相关 知识 。 


1.8.3 ”超级 账本 项 目 


超级 账本 (Hyperledger) 项 目 致力 于 开发 创建 授权 的 DApp 技 术 。Hyperledger fabric (或 称 simply fabric) 是 
Hyperledger 项 目的 一 个 实现 。 其 他 Hyperledger 实 现 还 有 lntel Sawtooth 和 R3 Corda 等 。 


fabric 是 一 个 去 中 心 化 的 授权 平台 ， 它 允许 在 其 上 运行 授权 的 DApp ( 叫 作 chaincode， 账 链 代 码 ) 。 用 户 需要 部 署 目 己 的 
fabric 实 例 ， 然 后 在 其 上 部 署 授权 的 DApp。 网 络 中 的 每 一 个 书 点 都 运行 一 个 fabric 实 例 。fabric 是 即 插 即 用 系统 ， 可 以 方便 地 即 
插 即 用 多 种 共识 协议 和 功能 。 


Hyperledger 使 用 区 块 链 数据 结构 。 以 Hyperledger 为 基础 的 区 块 链 目前 可 以 选择 没有 共识 协议 ( 即 NoOps 协 议 ) ， 或 者 使 
用 实用 拜占庭 容错 算法 (Practical Byzantine Fault Tolerance, PBFT) 共识 协议 。 它 有 一 个 特殊 节点 叫 作 证 书 颁 发 机 构 ， 该 节 
点 用 于 控制 谁 能 加 入 网 络 和 它们 能 做 什么 。 


1.8.4 IPFS 


星际 文件 存储 系统 (InterPlanetary File System, IPFS) 是 一 个 去 中 心 化 的 文件 系统 。1PFS 使 用 分 布 式 哈 希 表 
(Distributed Hash Table, DHT) 和 Merkle 有 向 无 环 图 (Directed Acyclic Graph, DAG) 数据 结构 。 它 使 用 类 似 于 
BitTorrent (比特 流 ) 的 协议 来 决定 如 何在 网 络 中 移动 数据 。IPFS 的 一 个 高 级 功能 是 它 支 持 文件 版 本 管理 。 为 了 实现 文件 版 本 管 
理 ， 它 使 用 了 类 似 于 Git 的 数据 结构 。 


尽管 被 称 为 去 中 心 化 的 文件 系统 ，IPFS 并 不 遵循 文件 系统 的 主要 属性 ， 即 在 文件 系统 中 ， 所 存储 的 内 容 会 一 直 保 留 到 被 删 
除 之 前 。1PFS 的 工作 原理 不 同一 一 每 一 个 节点 并 不 存储 全 部 文件 ， 存 储 的 是 需要 的 文件 。 如 果 一 个 文件 不 那么 受 欢 迎 ， 许 多 节 
点 就 没有 这 个 文件 ， 那 么 该 文件 很 有 可 能 从 网 络 中 消失 。 因 此 ， 许 多 人 更 喜欢 把 IPFS 称 为 去 中 心 化 的 、 点 对 点 的 文件 共享 应 
用 。 或 者 可 以 把 IPFS 当 作 完 全 去 中 心 化 的 BitTorrent， 也 就 是 说 ， 它 没有 追踪 器 ， 但 有 一 些 高 级 功能 。 


1. 工 作 原 理 


当 在 IPFS 中 存储 一 个 文件 时 ， 它 被 分 成 很 多 小 于 256KB 的 数据 块 (chunk) ， 并 生成 每 个 数据 块 的 哈 希 。 网 络 中 的 节点 在 一 
个 哈 希 表 中 存储 它们 需要 的 IPFS 文 件 及 其 哈 希 。 


IPFS 文 件 有 4 种 类 型 : blob、list、tree 和 commit。blob 代 表 一 个 实际 存储 在 IPFS 中 的 文件 的 数据 块 。list 代 表 完 整 的 文 
件 ， 因 为 它 包 含 blob 列 表 和 其 他 列表 。 由 于 列表 可 以 包含 其 他 列表 ， 因 此 它 帮 助 网 络 进行 数据 压缩 。tree ( 树 ) 代表 目录 ， 因 为 
七 包含 blob 列 表 、 列 表 、 其 他 树 和 commit。commit 文 件 代表 其 他 文件 的 版 本 历史 中 的 快照 。 由 于 list、tree 和 commit 与 其 他 
IPFS 文 件 有 连接 ， 于 是 形成 了 一 个 Merkle DAG, 


所 以 ， 用 尸 如 果 想 要 从 网 络 中 下 载 文 件 时 ， 只 需要 IPFS 列 表 文 件 的 哈 希 。 如 果 想 下 载 目 录 ， 则 只 需要 IPFS 树 文件 的 哈 希 。 


因为 每 个 文件 都 由 一 个 哈 希 进行 标识 ， 所 以 文件 名 不 容易 记 住 。 如 果 更 新 文件 ， 玖 需要 与 想 下 载 该 文件 的 所 有 人 分 享 新 的 哈 
希 。 为 了 解决 这 个 问题 ，IPFS 使 用 IPNS 功 能 ， 人 允许 用 目 行 认证 的 名 字 或 者 人 性 化 的 名 字 指 同 IPFS 文 件 。 


2.Filecoin 


阻碍 IPFS 成 为 去 中 心 化 文件 系统 的 主要 原因 是 节点 只 存储 了 它们 需要 的 文件 。Filecoin (文档 币 ) 是 一 个 类 似 于 IPFS 的 去 中 
心 化 文件 系统 ， 其 中 有 内 部 货币 激励 节点 存储 文件 ， 由 此 提高 文件 可 用 性 ， 并 使 其 更 像 一 个 文件 系统 。 


网 络 中 的 节操 通过 赚 取 文档 币 来 租用 磁盘 空间 ， 在 存储 /检索 文件 时 ， 需 要 伦 费 文档 币 。 
与 IPFS 拉 术 一 样 ，Filecoin 使 用 区 块 链 数 据 结 构 和 数据 可 检索 证 明 (Proof-of-Retrievability, PoR) 共识 协议 。 


在 写本 书 之 时 ，Filecoin 仍 在 开 友 阶段 ， 因 此 许多 事情 尚 不 明确 。 


1.8.5 Namecoin 


Namecoin 是 一 个 去 中 心 化 的 键 - 值 数 据 库 。 它 也 有 内 部 货币 ， 叫 作 域名 币 (Namecoin) 。Namecoin 使 用 区 块 链 数据 结 
构 和 工作 量 证 明 共 识 协议 。 


在 Namecoin 中 ， 可 以 存储 数据 的 键 - 值 对 。 为 了 注册 键 - 值 对 ， 需 要 花费 域名 币 。 注 册 之 后 ， 需 要 每 35999 个 区 块 更 新 一 
次 ， 否 则 与 密 铀 相关 的 数值 将 失效 。 更 新 也 需要 花费 域名 币 。 不 需要 更 新 密 钥 ， 也 就 是 说 ， 在 注册 之 后 不 需要 花费 任何 域名 币 来 
存储 密 钥 。 


Namecoin 有 一 个 命名 空间 (namespace) 功能 ， 人 允许 用 户 组 织 不 同 种 类 的 密 铀 。 任 何人 都 可 以 创建 命名 空间 ， 或 者 使 用 
现 有 命名 空间 组 织 密 钥 。 


最 受 欢 迎 的 命名 空间 有 a (应 用 特定 数据 ) 、d (域名 规范 ) ds (安全 域名 ) . id (标识 ) 、is (安全 标识 ) 、p m) 


bit 域 名 


如 要 访问 网 站 ， 浏 览 器 应 先 发 现 与 域名 相关 的 iP 地址 。 这 些 域 名 和 IP 地 址 映射 被 存储 在 DNS 服 务 端 中 ， 受 大 机 构 控 制 。 
此 ， 域 名 易于 审查 。 如 果 网 站 在 做 非法 勾当 ， 或 者 导致 某 些 损失 ， 或 者 出 于 一 些 其 他 原因 ， 大 机 构 通 单 会 天 闭 域名 。 


正 因 如 此 ， 就 需要 一 个 去 中 心 化 的 域名 数据 库 。 因 为 Namecoin 就 像 DNS 服务 端 一 样 存储 键 - 值 数据 ， 所 以 Namecoin 可 用 
于 实现 去 中 心 化 的 DNS， 而 且 已 经 用 于 该 用 途 。d 和 ds 命名 空间 包含 以 .bit 结 尾 的 密 钥 ， 代 表 .bit 域 名 。 从 技术 上 看 ， 命 名 空间 对 
于 密 钥 没 有 任何 命名 协定 ,但 是 Namecoin 的 所 有 证 点 和 客户 端 同意 该 命名 协定 。 如 果 想 在 d 和 ds 命名 空间 存储 非法 的 密 钥 ， 那 
AS Rima iets. 


支持 .bit 域 名 的 浏览 器 需要 查看 Namecoin 的 d 和 ds 命名 空间 ， 以 友 现 与 .bit 域 名 相关 的 iP 地址 。 


d 和 和 ds 命名 空间 之 间 的 区 别 是 : ds 存储 支持 TLS 的 域名 ， 而 d 存 储 不 支持 TLS 的 域名 。 我 们 已 经 使 DNS 去 中 心 化 了 ， 也 可 以 使 
发 放 TLS 证 书 去 中 心 化 。 


这 是 TLS 在 Namecoin 中 的 工作 原理 。 用 户 创 建 自 签 名 的 证 书 ， 并 在 Namecoin 中 存储 证 书 。 当 一 个 对 .bit 域 名 支持 TLS 的 客 
户 端 试图 访问 一 个 安全 的 .bit 域 名 时 ， 它 将 服务 端 返回 的 证 书 哈 希 和 Namecoin 中 的 哈 希 存储 进行 匹配 ， 如 果 匹 配 ， 则 继续 与 服 


务 新 进 行 更 多 通信 。 


@ 使 用 Namecoin 形 成 的 去 中 心 化 DNS 是 第 一 个 解决 Zooko triangle Jiko Zooko triangle 定 义 了 有 三 个 属性 的 应 用 ， 即 去 
中 心 化 、 身 份 和 安全 性 。 数 字 身 份 不 仅 可 以 用 于 代表 一 个 人 ， 还 可 以 代表 一 个 域 、 一 个 公司 或 者 其 他 事物 。 


1.8.6 Atr 
达 世 币 (Dash) 是 一 种 类 似 于 比特 币 的 去 中 心 化 货币 。 它 使 用 区 块 链 数 据 结构 和 工作 量 证 明 共 识 协 议 ， 并 解决 了 比特 币 面 
临 的 一 些 主 要 问题 。 以 下 是 比特 币 面临 的 一 些 问 题 : 


要 交易 马上 完成 。 这 是 因为 比特 币 网 络 的 挖 矿难 度 不 断 调整 ， 平 均 每 10 分 


. 交易 需要 几 分 钟 完成 ， 但 在 目前 的 环境 下 通常 需 
多 关于 控 矿 的 内 容 。 


钟 创建 一 个 区 块 。 在 本 书 中 ， 我 们 将 在 后 面 学 习 更 


尽管 账户 没有 与 其 相关 的 身份 ， 但 是 在 交易 所 里 用 比特 币 和 真实 贷 币 进行 兑换 或 者 用 比特 币 买 东西 都 是 可 以 追溯 的 ， 因 此 
交易 所 或 者 商户 可 以 把 用 户 的 身份 透露 给 监管 机 构 。 如 果 在 自己 的 节点 上 运行 发 送 / 接 收 交 易 ， 则 ISP 可 以 看 见 比 特 币 地 址 ， 还 可 
以 用 IP 地 址 追踪 所 有 者 ， 因 为 在 比特 币 网 络 中 广播 的 信息 不 是 加 密 的 。 


达 世 币 的 目标 是 通过 使 交易 几乎 瞬间 完成 并 隐藏 交易 账户 的 信息 来 解决 上 述 问题 ， 还 可 以 防止 他 人 用 IsSP 追 蹊 所 有 者 。 


比特 币 网 络 中 有 两 种 节点 ， 即 矿工 节点 和 普通 节点 。 但 Dash 中 有 三 种 节点 ， 即 矿工 节点 (minernode) 、 主 节点 
(master node) 和 普通 节点 (ordinary node) 。 主 节点 是 使 Dash 与 众 不 同 的 原因 。 


1. 去 中 心 化 的 治理 和 预算 编制 


要 建立 一 个 主 节点 ， 用 户 需 要 拥有 1000 个 达 世 币 和 一 个 静态 IP 地 址 。 在 Dash 网 络 中 ， 主 节点 和 矿工 都 赚 取 达 世 币 。 挖 出 一 
个 区 块 ，45% 收 益 归 矿工 ，45% 收 葵 归 主 节点 ， 剩 余 的 10% 留 给 系统 预算 。 


主 书 点 使 去 中 心 化 的 治理 和 预算 编制 成 为 可 能 。 由 于 去 中 心 化 的 治理 和 预算 编制 系统 ，Dash 被 称 为 DAO， 因 为 这 束 是 它 的 
确切 合 义 。 


网 络 中 的 主 节点 就 像 股 东 ， 也 就 是 说 ， 它 们 有 权利 决定 剩余 10% 的 达 世 币 归 谁 。 这 10% 的 达 世 币 通常 用 于 资助 其 他 项 目 。 
每 个 主 节点 都 有 能 力 使 用 一 次 投票 权 (vote) 批准 项 目 。 对 项 目的 讨论 在 网 络 以 外 进行 ， 但 投票 是 在 网 络 中 进行 的 。 
Q ,0 户 标识 提供 了 一 种 可 能 的 解决 办 法 ， 也 就 是 说 ， 主 节点 可 以 民主 地 选择 节点 来 验证 用 户 标 


识 。 该 节点 背后 的 人 或 者 单位 可 以 手动 验证 用 户 文 档 。 回 报 的 一 部 分 还 可 以 回 到 这 个 节点 。 如 果 该 节点 不 提供 良好 的 服务 ， 那 么 
主 节点 可 以 投票 给 另 一 个 节点 。 对 于 解决 去 中 心 化 的 标识 问题 来 说 ， 这 不 失 为 一 个 好 办 法 。 


2. 去 中 心 化 服务 


主 节 点 还 形成 一 个 提供 多 种 服务 的 服务 层 ， 而 非 仅 仅 批 准 或 者 拒绝 一 个 提案 。 主 忆 点 提供 服务 的 原因 是 它们 提供 的 服务 越 
多 ， 网 络 的 功能 束 越 多 ， 从 而 增加 用 尸 和 交易 。 这 样 能 提高 达 世 币 的 价值 ， 使 区 块 回报 变 得 更 高 ， 由 此 帮助 主 节 扣 赚 取 更 多 利 


iB. 


c pmdegusWPrivatesend (提供 匿名 的 混合 币 服务 ) . InstantSend (提供 几乎 即时 交易 的 服务 ) . DAPI ( 供 去 中 心 化 
API 的 服务 ， 这 样 用 户 不 需要 运行 节点 ) 等 服务 。 


在 某 个 特定 时 间 ， 只 有 10 个 主 节 点 馈 选 中 。 选 择 算法 将 使 用 当前 区 块 的 哈 希 选择 这 10 个 主 节 操 。 然 后 ， 从 这 些 主 布点 友 出 
服务 请 求 。 从 大 部 分 节点 接收 的 结果 补 认 为 是 正确 的 ， 这 束 是 对 主 节 后 提供 的 服务 达成 共识 的 办 法 。 


服务 证 明 (Proof of Service, PoS) 共识 协议 用 于 确保 主 节点 在 线 、 应 答 和 更 新 区 块 链 。 


1.8.7 BigChainDB 


BigChainDB 人 允许 用 户 部 署 目 己 的 、 授 权 的 或 者 免 权 限 去 中 心 化 数据 库 。 它 使 用 区 块 链 数据 结构 以 及 其 他 多 种 特定 数据 库 数 
据 结 构 。 在 写本 书 之 时 ，BigChainDB 仍 处 于 开发 阶段 ， 所 以 许多 事情 尚 不 明确 。 


BigChainDB 还 提供 了 许多 其 他 功能 ， 例 如 丰富 的 权限 、 碍 询 、 续 性 扩展 以 及 文 持 多 资产 和 federation 共 识 协 议 等 。 


1.8.8 OpenBazaar 


OpenBazaar 是 一 个 去 中 心 化 的 电子 商务 平台 ， 可 以 在 其 上 买卖 物品 。OpenBazaar 中 的 用 户 不 是 匿名 的 ， 因 为 其 |P 地 址 被 
RJ. TERHILAZESES. RAKSHA. 


OpenBazaar 使 用 Kademilia 分 布 式 哈 希 表 数 据 结 构 。 为 了 使 这 些 项 在 网 络 中 可 视 ， 卖 方 必须 建立 证 点 并 维持 其 运行 。 


OpenBazaar 使 用 工作 量 证 明 共 识 协 议 防止 账户 被 算 改 。 它 使 用 proof-of-burn、CHECKLOCKTIME 验 证 和 基于 保证 金 的 共 
识 协 议 ， 防 止 评分 和 评价 被 自 改 。 


买 万 和 卖 万 用 比特 币 进 行 交 易 。 买 万 在 购买 时 可 以 添加 一 个 中 间 人 。 如 果 买 卖 双方 有 和 争端， 由 中 间 人 负责 解决 。 任 何人 都 可 
以 是 网 络 中 的 中 间 人 ， 中 间 人 通过 解决 争端 赚 取 于 续费 。 


1.8.9 Ripple 


Ripple (mix) 是 一 个 去 中 心 化 的 转账 平台 。 它 允许 史 现 货币 、 数 字 货 币 和 大 未 商品 。 它 使 用 区 块 链 数据 结构 ， 并 且 有 目 己 
的 共识 协议 。 在 Ripple 相 关 文 档 中 ， 找 不 到 “区 块 ” 和 “区 块 链 ”等 词汇 ; 而 是 用 “账本 ” (ledger) RRE. 


在 Ripple 中 ， 通 过 信任 链 进 行 钱 和 商品 交换 ， 方 式 类 似 于 hawala 网 络 。Ripple 中 有 两 种 节点 ， 即 网 关 (gateway) 和 普通 
节点 。 网 关 支 持 一 种 或 多 种 货币 和 /或 商品 的 存 取 。 为 了 在 Ripple 网 络 中 变 成 网 关 ， 需 要 作为 网 关 的 权限 形成 一 个 信任 链 。 网 关 
通 单 是 已 经 注册 的 金融 机 构 、 交 易 所 、 商 人 等 。 


每 个 用 户 和 网 关 都 有 一 个 账户 地 址 。 每 个 用 户 需要 把 他 们 信任 的 网 天 地 址 添加 到 信任 列表 中 ， 形 成 一 个 信任 网 天 列表 。 对 于 
上 友 现 谁 值得 信赖 ， 并 没有 任何 共识 ， 这 完全 依赖 用 户 一 一 用 户 目 行 承担 信任 一 个 网 天 的 风险 ， 即 便 网 关 可 以 添加 它们 信任 的 网 
A. 


来 看 一 个 例子 : 住 在 印度 的 用 户 X 如 何 能 够 向 住 在 美国 的 用 户 Y 上 友 送 ?500 美 元。 假设 在 印度 有 一 个 网 天 XX， 收 取现 金 (实物 
现金 或 者 在 网 上 用 卡 支 付 ) 且 只 用 印度 卢比 给 用 户 Ripple 余 额 。X 将 访问 XX 办 公 室 或 者 网 站 ， 人 存 入 30000 印 度 户 比 ， 然 后 XX 广 播 
交易 说 “从 X30000 印 度 户 比 ”。 现 在 假设 在 美国 有 一 个 网 关 YY， 它 只 允许 美元 交易 且 Y 信 任 YY 网 天 。 假 设 网 天 XX 和 YY 不 信任 
役 此 。 由 于 X 和 Y 不 信任 一 个 共同 的 网 关 ，XX 和 YY 不 信任 彼此 ， 导 致 XX 和 YY 不 广 持 同样 的 货币 ， 因 此 ，X 为 了 转账 给 Y， 融 需要 
发 现 一 个 中 间 人 网 关 形 成 一 个 信任 链 。 假 设 还 有 一 个 网 关 ZZ，XX 和 YY 都 信任 ZZ，ZZ 支 持 美 元 和 印度 卢比 。 现 在 X 可 以 发 送 交 
易 ， 将 50000 印 度 户 比 从 XX 转 给 ZZ，ZZ 把 钱 品 成 美元 ， 然 后 把 钱 友 送 给 YY， 让 YY 把 钱 给 Y。 现 在 X 闪 Y$500，YY 人 从 Y$500，ZZ 


RYY$500, XXXZZ 30000B 印 度 户 比 。 但 是 这 都 没什么 ， 因 为 它们 互相 信任 ， 而 此 前 X 和 Y 不 互相 信任 。 但 是 只 要 XX、YY 和 ZZ 
想 ， 它 们 随时 可 以 在 Ripple 之 外 转账 ， 或 者 翻转 交易 扣除 蒜 项 。 


Ripple 也 有 内 部 货币 ， 叫 作 XRP (或 瑞 波 币 ) 。 发 送 至 网 络 中 的 每 一 个 交易 会 耗费 一 些 瑞 波 币 。 由 于 瑞 波 币 是 Ripple 自 有 的 
货币 ， 它 可 以 不 需要 信任 就 被 发 送 给 网 络 中 的 任何 人 。 在 形成 信任 链 时 ， 可 以 使 用 瑞 波 币 。 记 住 ， 每 一 个 网 关 有 自己 的 货币 汇 
率 。 瑞 波 币 不 是 由 挖 矿 生 成 的 相反， 最 初 就 有 1000 亿 个 瑞 波 币 ， 它 们 最 初 由 Ripple 公 司 拥有 。 出 于 多 种 原因 ， 瑞 波 币 是 手动 


供给 的 。 


所 有 交易 都 锌 记录 在 去 中 心 化 的 账本 中 ， 形 成 不 可 更 改 的 历史 。 需 要 共识 确保 所 有 节操 在 一 个 给 定时 间 的 账本 都 一 怪 。 在 


Ripple 中 ， 有 第 三 种 节点 ， 叫 作 验 证 器 (validator) ， 它 是 共识 协议 的 一 部 分 ， 验 证 器 负责 验证 人 交易。 任何 人 都 可 以 成 为 验证 
器 。 但 是 其 他 市 点 维护 一 个 可 以 信任 的 验证 器 列表 。 该 列表 被 称 为 唯一 节点 列表 (Unique Node List, UNL) 。 验 证 器 也 有 


UNL， 即 验证 器 信任 的 验证 器 ， 因 为 验证 器 也 想 达 成 共识 。 目 前 ， 由 Ripple 决 定 可 以 信任 的 验证 器 列表 ， 但 是 如 果 网 络 认为 
Ripple 选 择 的 验证 器 不 值得 信任 ， 束 可 以 在 节点 软件 中 修改 列表 。 


可 以 拿 出 一 个 以 前 的 账本 ， 把 随后 友 生 的 全 部 交易 都 填 上 去 ， 形 成 一 个 新 账本 。 为 了 同意 当前 账本 ,市 点 必须 同意 以 前 的 账 
本 和 随后 友 生 的 全 部 交易 。 在 创建 一 个 新 账本 之 后 ， 书 点 (普通 节点 和 验证 器 ) 局 动 一 个 计时 器 ( 几 稍 钟 长 ， 大 概 5s) ， 并 收集 
在 创建 以 前 的 账本 时 a 到达 的 新 交易 。 当 计时 器 停 下 时 ， 它 接收 人 至少 80% 的 UNL 认 为 合法 的 交易 ， 形 成 下 一 个 账本 。 验 证 器 向 网 
络 广播 一 个 提案 (proposal， 即 它们 认为 合法 的 、 用 于 形成 下 一 个 账本 交易 的 一 系列 交易 ) 。 如 果 它 们 决定 根据 UNL 提 案 和 其 
他 因素 改变 合法 交易 的 列表 ， 验 证 器 可 以 对 同一 个 账本 用 不 同 的 交易 集合 ， 多 次 广播 提案 。 所 以 用 户 仪 需要 等 待 ?~ 10s， 由 网 


络 确认 交易 。 


有 人 质疑 ， 每 个 节点 可 能 有 不 同 的 UNL， 是 否 会 使 账本 生成 许多 不 同 的 版 本 ? 其 实 只 要 UNL 之 间 有 最 低 程度 的 相互 连接 ， 
束 会 迅速 达成 共识 ， 这 是 因为 每 一 个 诚实 节 扣 的 主要 目标 束 是 达成 共识 。 


1.9 I 


AN 一 器 


在 本 章 中 ， 我 们 学 习 了 DApp 的 概念 ， 初 步 了 解 了 DAppb 的 工作 原理 以 及 其 面临 的 一 些 挑 战 和 应 对 挑战 的 多 种 方法 。 最 后 ， 我 
们 接触 了 一 些 广 受 欢 迎 的 DApp， 了 解 了 它们 的 特别 之 处 和 工作 原理 。 


Bee ”以 太 坊 的 工作 原理 


在 前 一 章 中 ， 我 们 了 解 了 DApp 的 概念 ， 还 了 解 了 一 些 热门 DApp， 其 中 之 一 便 是 以 太 坊 。 目 前 ， 以 太 坊 是 继 比特 币 之 后 最 
受 欢 迎 的 DApp。 在 本 草 中 ， 我 们 将 深入 学 习 以 太 坊 的 工作 原理 及 其 用 途 ， 还 将 看 到 重要 的 以 太 坊 客 尸 端 和 节操 实现 。 


在 本 章 中 ， 我 们 将 讲解 以 下 内 容 : 
` 以 太 坊 用 户 账户 。 


: 智能 合约 及 其 工作 原理 。 


` 以 大 坊 虚 拟 机 (EVM) 。 

: 在 工作 量 证 明 共 识 协议 中 挖 矿 如 何 进 行 。 
-学习 如 何 使 用 geth 命 令 。 

` 建立 以 太 坊 钱包 和 浏览 器 钱包 (Mist) 。 
- Whispetr 和 Swarm 概 览 。 


“ 以 太 坊 的 未 来 。 


2.1 LUKE SS 


以 太 坊 (Ethereum) 是 一 个 去 中 心 化 的 平台 ， 可 以 在 其 上 部 署 DApp。DApp 是 用 一 个 或 者 更 多 个 智能 合约 创建 的 ， 使 用 
Solidity 编 程 语言 编写 智能 合约 。 智 能 合约 完全 按照 程序 运行 ， 而 且 防 停机 、 防 审查 、 防 欺诈、 防 第 三 方 干扰 。 在 以 太 坊 中 ， 编 
写 智能 合约 可 以 使 用 好 几 种 编程 语言 ， 包 括 Solidity、LLL 和 Serpent， 其 中 Solidity 最 受 欢 迎 。 以 太 坊 有 一 种 内 部 货币 叫 作 以 太 
m (Ether) ， 部 署 智能 合约 或 者 调用 其 方法 需要 用 到 以 太 币 。 和 任何 其 他 DApp 一 样 ， 智 能 合约 可 以 有 多 个 实例 ， 且 每 个 实例 
都 有 目 己 专门 的 地 址 。 用 尸 账 尸 和 智能 合约 都 可 以 持 有 以 太 币 。 


以 太 坊 使 用 区 块 链 数据 结构 和 工作 量 证 明 共 识 协议 。 智 能 合约 可 以 通过 发 送 交 易 调用 或 者 通过 其 他 合约 调用 。 有 两 种 网 络 中 
的 节点 : 普通 书 点 和 人 矿工。 普通 节点 只 备份 区 块 链 上 的 数据 ， 而 矿工 通过 控 矿 创建 区 块 链 。 


2.2 ”以 太 坊 账户 


要 创建 以 大 坊 账户 ， 只 需要 一 个 非 对 称 加 密 密 钥 对 一 一 由 不 同 的 算法 (例如 RSA、ECC 等 ) 生成 。 以 太 坊 使 用 椭圆 曲线 加 密 
算法 (ECC) ，ECC 有 多 个 参数 用 来 调节 速度 和 安全 性 ， 以 太 坊 使 用 secp256k1 参 数 。 深 入 学 习 ECC 及 其 参数 需要 一 定 的 数学 知 
识 ， 而 使 用 以 太 坊 创建 DApp 不 需要 深入 理解 ECC 及 其 参数 。 


以 太 坊 使 用 256 位 加 密 。 以 太 坊 私 钥 / 公 钥 是 一 个 256 位 数 。 因 为 处 理 器 不 能 表示 这 么 大 的 数 ， 所 以 它 被 编译 成 长 度 为 64 的 十 


入 进 制 字符 串 。 
每 个 账户 用 一 个 地 址 表示 。 有 了 密 钥 之 后 ， 融 需要 生成 地 址 。 从 公 钥 生成 地 址 的 过 程 如 下 : 
1) 生成 公 钥 的 keccak-256 哈 希 。 它 将 给 出 一 个 256 位 的 数字 。 
2) 丢弃 前 面 的 96 位 ， 即 12 字 节 。 现 在 得 到 160 位 二 进 制 数据 ， 即 20 字 市。 
3) 把 地 址 编译 成 十 入 进 制 的 字符 串 。 最 后 将 得 到 一 个 40 字 符 的 字 节 串 ， 融 是 账户 地 址 。 


现在 任何 人 都 可 以 友 送 以 太 币 到 这 个 地 址 。 


交易 是 一 个 签名 数据 包 ， 用 于 从 一 个 账 尸 同 另 一 个 账户 或 者 向 一 个 合约 转 以 太 币 、 调 用 合约 方法 或 者 部 署 一 个 新 合约 。 交 易 
使 用 椭圆 曲线 数字 签名 算 ; 去 (ECDSA) 签名 ，ECDSA 是 一 种 基于 ECC 的 数字 签名 算法 。 交 易 包含 信息 接收 者 、 识 别 友 起 人 及 其 
意愿 的 签名 、 要 转账 的 以 太 币 数量 、 交 易 执行 允许 进行 的 计算 资源 最 大 值 ( 叫 作 gas 上 限 ) 以 及 交易 友 起 人 愿意 为 单位 计算 资源 
文 付 的 费用 ( 叫 作 gas 价 格 ) 。 如 果 交 易 目的 是 调用 合约 万 法 ， 则 还 包含 输入 数据 ， 如 果 其 目的 是 部 署 合约 ， 则 可 以 包含 初始 化 
代码 。 用 交易 所 消耗 的 gas 乘 以 gas 价 格 计算 得 到 交易 费 。 为 了 友 送 以 太 币 或 者 执行 合约 方法 ， 需 要 同 网 络 广播 交易 。 友 起 人 需 
要 用 私 钥 签 署 交 易 。 


On 则 称 为 交易 已 确认 。 推 荐 在 假设 交易 已 确认 之 前 ， 等 待 15 个 确认 (15 个 区 块 
产生 在 交易 所 在 的 区 块 后 面 ) 。 


24 ”共识 


以 太 坊 网 络 中 的 每 个 节点 包含 区 块 链 的 一 个 备份 。 用 记 需 要 确保 节操 不 能 够 修改 区 块 链 ， 还 需要 一 个 机 制 检查 区 块 是 否 合 
法 ， 如 果 遇 到 两 个 不 同 的 合法 区 块 链 ， 需 要 有 办 法 确定 选择 哪个 。 


以 太 坊 使 用 工作 量 证 明 共 识 协 议 防 止 区 块 链 被 修改 。 工 作 量 证 明 系统 需要 解决 一 个 复杂 问题 以 创建 一 个 新 的 区 块 。 解 决 问题 
需要 大 量 算 力 ， 这 丈 使 创建 区 块 很 困难 了 。 在 工作 量 证 明 系 统 中 ， 创 建 区 块 的 过 程 称 为 挖 矿 。 矿 工 (miner) 是 网 络 中 控 区 块 的 
节点 。 使 用 工作 量 证 明 的 所 有 DApp 并 不 一 定 都 使 用 同样 的 算法 。 使 用 什么 算法 取决 于 矿工 需要 解决 的 问题 、 问 题 难 度 值 、 需 要 
多 长 时 间 解 决 等 。 我 们 将 学 习 与 以 太 坊 有 关 的 工作 量 证 明 。 


任何 人 都 可 以 成 为 网 络 中 的 矿工 。 每 个 矿工 独 目 解决 问题 ， 第 一 个 解决 问题 的 矿工 是 胜利 者 ， 它 得 到 的 回报 是 ?个 以 太 币 和 
该 区 块 中 全 部 交易 的 交易 费 。 如 果 你 的 处 理 器 比 网 络 中 的 其 他 节点 更 强大 ， 也 并 不 意味 着 你 思 会 成 功 ， 因 为 所 有 矿工 要 解决 的 问 
题 的 参数 并 不 完全 相同 。 但 是 如 果 你 有 一 台 比 网 络 中 的 其 他 节点 都 强大 的 处 理 器 ， 成 功 的 概率 会 比较 大 。 网 络 安 全 不 是 用 矿工 忌 
数 衡量 的 ， 而 是 用 网 络 的 全 部 算 力 衡量 的 。 


区 块 链 中 有 多 少 个 区 块 没有 限制 ， 可 以 生成 的 以 太 币 忆 数 也 没有 限制 。 矿 工 一 旦 成 功 控 到 区 块 ， 就 向 网 络 中 的 所 有 其 他 节点 
广播 该 区 块 。 区 块 有 一 个 区 块头 (header) 和 一 系列 交易 。 每 一 个 区 块 存储 前 一 个 区 块 的 哈 希 值 ， 由 此 创建 一 个 相连 的 链 。 


让 我 们 来 看 矿工 需要 解决 的 问题 是 什么 以 及 如 何在 高 水 平 解决 问题 。 为 了 挖 区 块 ， 矿 工 首 先 从 收 到 的 广播 中 收集 新 的 、 未 挖 
出 的 交易 ， 然 后 滤 掉 不 合法 的 交易 。 合 法 的 交易 必须 满足 正确 地 使 用 私 钥 签 名 、 账 户 有 足够 的 余额 进行 交易 等 条 件 。 现 在 矿工 创 
建 一 个 有 区 块头 和 内 容 的 区 块 。 内 容 (content) 是 区 块 包含 的 交易 列表 。 区 块头 包含 前 一 个 区 块 的 哈 希 、 区 块 序号 、 随 机 数 

(nonce) 、 目 标 值 (target) 、 时 间 戳 (timestamp) 、 难 度 值 (difficulty) 、 矿 工地 址 (address) AS. MERETE 
块 初始 时 间 。 随 机 数 是 一 个 没有 意义 的 值 ， 纯 粹 是 为 了 设置 一 个 小 于 或 等 于 目标 值 的 区 块 哈 希 。 以 太 坊 使 用 ethash 哈 希 算法 。 
发 现 随机 数 的 唯一 方法 是 穷尽 所 有 可 能 。 目 标 值 是 一 个 256 位 的 数字 ， 根 据 不 同 的 因素 计算 。 区 块头 的 难度 值 是 目标 值 的 一 种 不 
同 表述 方法 。 目 标 值 越 低 ， 发 现 随 机 数 需 要 的 时 间 越 多 ; 目标 值 越 高 ， 需 要 的 时 间 越 少 。 计 算 问题 难度 值 的 公式 如 下 : 


current block difficulty = previous block difficulty + 
previous block difficulty // 2048 * max(1 - (current block timestamp - 
previous blocktimestamp) // 10, -99) + int(2 ** ((current block number // 
100000) - 2)) 


MAF Raye KERR, Eit tiscz CEDAR REAN AAKER, TAESSEXDCIARBS 
目标 值 和 随机 数 是 否 合法 、 矿 工 是 否 得 到 合法 的 回报 等 。 


0 如 果 网 络 中 的 节点 接收 到 两 个 不 同 的 合法 区 块 链 ， 那 么 所 有 区 块 的 整体 难度 值 较 高 的 那个 区 块 链 被 视 为 合法 的 区 块 
链 。 


例如 ， 假 设 网 络 中 的 一 个 节点 想 改 变 一 个 区 块 中 的 一 些 交 易 ， 束 需要 重新 计算 该 块 以 及 该 块 后 面 所 有 区 块 的 随机 数 。 可 是 在 
该 节操 计算 的 同时 ， 网 络 其 他 证 点 已 经 又 挖 出 了 许多 新 的 区 块 ， 因 此 当 它 重新 计算 到 最 新 区 块 时 会 因 整 体 难度 值 较 低 而 被 系统 拒 
绝 。 可 见 ， 私 目 自 改 账本 的 难度 是 非常 大 的 。 


2.5 JEJE 


计算 区 块 目标 值 的 公式 需要 用 到 当前 时 间 戳 ， 且 每 个 区 块 在 区 块头 附加 了 当前 时 间 戳 。 没 有 什么 机 制 可 以 阻止 矿工 在 挖 新 区 
块 时 使 用 其 他 时 间 戳 (而 非 当前 时 间 戳 ) ， 但 是 它们 一 般 不 会 那么 做 ， 因 为 时 间 截 验证 会 失败 ， 其 他 节操 不 会 接受 该 区 块 ， 这 样 
就 妆 费 了 矿工 的 资源 。 当 一 个 矿工 广播 一 个 新 挖 出 的 区 块 时 ， 其 他 节操 对 其 时 间 礁 的 验证 取决 于 其 时 间 堆 是否 大 于 前 一 个 区 块 的 
时 间 戳 。 如 果 一 个 矿工 使 用 的 时 间 戳 大 于 当前 时 间 戳 ， 则 难度 值 较 低 ， 因 为 难度 值 与 当前 时 间 戳 成 反比 ， 因 此 网 络 将 接受 区 块 时 
间 截 是 当前 时 间 礁 的 矿工 ， 因 为 它 的 难度 值 比较 高 。 如 果 一 个 矿工 使 用 的 时 间 稚 大 于 前 一 个 区 块 时 间 截 ， 且 小 于 当前 时 间 枚 ， 难 
度 值 会 高 一 些 ， 因 此 要 和 花 费 更 多 时 间 控 区 块 。 等 到 区 块 被 挖 出 的 时 候 ， 网 络 可 能 产生 了 更 多 区 块 ， 因 此 该 区 块 会 被 拒绝 ， 因 为 往 
往 有 恶意 矿工 的 区 块 链 难度 值 会 低 于 网 络 中 的 区 块 链 难度 值 。 出 于 以 上 原因 ， 丰 工 总 是 使 用 准确 的 时 间 戳 ， 人 否则 他 们 会 一 无 所 获 。 


2.6 ”随机 数 


随机 数 是 一 个 64 位 未 签名 证 书 。 随 机 数 是 一 个 问题 的 解决 办 法 ,矿工 不 断 地 尝试 随机 数 ， 直 到 友 现 目标 值 。 有 人 也 许 会 好 
奇 ， 如 果 某 个 矿工 拥有 的 算 力 比 网 络 中 的 任何 其 他 矿工 都 大 ， 他 是 否 忌 会 第 一 个 发 现 随 机 数 ? 答案 是 不 会 。 


每 个 矿工 挖 的 区 块 的 哈 希 是 不 同 的 ， 因 为 哈 希 取决 于 如 时 间 截 、 矿 工地 址 等 内 容 ， 而 且 对 于 所 有 矿工 来 说 这 些 内 容 很 可 能 是 
不 一 样 的 。 因 此 ， 解 决 问题 并 不 是 一 场 比 赛 ， 而 更 像 是 一 件 碰 运气 的 事 。 当 然 ， 矿 工 可 能 因为 算 力 大 而 走运 ， 但 那 并 不 意味 着 该 
矿工 忌 会 友 现 下 一 个 区 块 。 


2.7 ”区 块 时 间 


我 们 看 到 的 区 块 难度 值 公 陈 使 用 了 一 个 长 达 10s 的 国 值 ， 以 确保 挖 出 父 区 块 和 子 区 块 的 时 间 差 在 10s 和 20s 之 间 。 但 为 什么 是 


10~ 20s， 而 非 其 他 数值 呢 ? 为 什么 时 间 差 是 恒定 的 ， 而 非 难度 值 是 恒定 的 ” 


假设 有 一 个 恒定 的 难度 值 ， 矿 工 只 需要 友 现 一 个 随机 数 使 得 区 块 的 哈 希 小 于 等 于 该 难度 值 即 可 。 假 设 该 难度 值 大 ， 且 在 此 情 
况 下 ， 用 户 又 无 法 估算 用 户 间 友 送 以 太 币 的 时 间 延 迟 。 如 果 网 络 算 力 不 足 ， 计 算 随 机 数 需要 较 长 时 间 ， 那 么 用 户 需 要 等 竺 很 长 时 
间 来 确定 交易 。 有 时 网 络 算 力 元 足 ， 可 能 很 笠 运 ， 很 快 惑 友 现 了 随机 数 ， 用 户 交 易 确 认 融 比较 快 。 这 类 系统 延迟 不 确定 的 特 氮 目 
然 很 难受 到 用 户 青 睐 ， 因 为 用 尸 总 想 知 道 需 要 多 长 时 间 完 成 交易 ， 融 像 我 们 从 一 个 银行 账 尸 向 另 一 个 银行 账户 汇 秋 ， 银 行 会 告诉 
我 们 在 多 长 时 间 之 内 会 完成 ;L 蒜 。 如 果 设 定 的 难度 值 小 ， 它 将 影响 区 块 链 的 安全 ， 因 为 大 矿工 可 以 比 小 矿工 更 快 控 出 区 块 ， 网 络 
中 最 大 的 矿工 束 会 拥有 控制 DApp 的 能 力 。 不 可 能 友 现 一 个 可 以 使 网 络 稳定 的 恒定 难度 值 ， 因 为 网 络 算 力 并 非 恒定 值 。 


现在 我 们 知道 了 ， 为 什么 总 是 需要 有 一 个 相对 稳定 的 生成 区 块 的 平均 时 间 ( 即 区 块 时 间 ) 。 问 题 是 最 合适 的 平均 时 间 是 多 
长 。 它 可 以 短 至 1s， 长 至 几乎 无 限 多 秒 。 降 低 难度 值 可 以 使 平均 时 间 较 短 ， 反 之 增加 难度 值 可 以 使 平均 时 间 较 长 。 但 是 ,平均 时 
间 的 长 短 各 有 什么 优 缺 点 呢 ? 在 讨论 之 前 ， 首 先 需 要 知道 无 效 无 效 块 (stale block) 是 什么 。 


如 果 两 个 矿工 用 几乎 相同 的 时 间 控 下 一 个 区 块 ， 会 友 生 什 么 呢 ? 两 个 区 块 肯 定 都 是 合法 的 ， 但 是 区 块 链 不 能 包含 区 块 序号 相 
同 的 两 个 区 块 ， 而 且 两 个 矿工 都 得 不 到 回报 。 尽 管 这 是 个 单 见 问 题 ， 解 决 方法 却 很 简单 ， 最 后 难度 值 较 高 的 区 块 链 将 被 网 络 接 
受 。 所 以 最 后 被 忽略 的 合法 区 块 叫 作 无 效 无 效 块 。 


网 络 中 生成 的 无 效 无 效 块 忌 数 与 生成 新 区 块 所 需 的 平均 时 间 成 有 反比。 更 短 的 区 块 生成 时 间 蕊 味 着 新 挖 出 来 的 区 块 同 整个 网 络 
广播 的 时 间 更 短 ， 矿 工友 现 问 题解 决 办 法 的 概率 更 大 ， 所 以 当 区 块 向 整个 网 络 广播 时 ， 其 他 一 些 矿工 可 能 也 解决 了 问题 并 进行 了 
广播 ， 由 此 产生 了 无 效 块 。 但 是 如 果 生成 区 块 的 平均 时 间 长 一 点 ， 多 个 矿工 能 解决 问题 的 概率 束 小 一 点 ， 而 且 即 使 它们 都 解决 了 
问题 ， 也 很 可 能 存在 时 间 差 ， 在 这 个 时 间 差 里 ， 第 一 个 被 解决 的 区 块 就 可 以 进行 广播 ， 另 一 个 矿工 就 可 以 停止 挖 那 个 区 块 并 继续 
挖 下 一 个 区 块 。 如 果 无 效 块 在 网 络 中 经 单 出 现 ， 融 会 出 现 大 问题 ; 如 果 仅 是 偶尔 出 现 ， 融 对 网 络 没有 损害 。 


但 是 无 效 块 有 什么 问题 呢 ? 它们 延迟 了 交易 确认 。 当 两 个 矿工 几乎 同时 挖 一 个 区 块 时 ， 它 们 可 能 有 不 同 的 交易 ， 因 此 如 果 交 
易 出 现在 其 中 ， 融 不 能 说 交易 已 经 确认 了 ， 因 为 交易 中 出 现 的 区 块 可 能 是 无 效 块 。 我 们 应 该 等 待 再 挖 出 几 个 区 块 。 无 效 块 导 致 平 
均 确 认 时 间 不 等 于 生成 区 块 的 平均 时 间 。 


无 效 块 会 影响 区 块 链 安全 吗 ? 管 案 是 肯定 的 。 我 们 知道 网 络 安全 由 网 络 中 矿工 的 全 部 算 力 衡量 。 当 算 力 增长 时 ， 难 度 值 也 要 
增加 ， 以 确保 区 块 不 是 在 平均 时 间 之 前 生成 的 。 所 以 更 高 的 难度 值 意 味 着 更 安全 的 区 块 链 一 一 节操 想 臭 改 区 块 链 将 需要 更 多 得 
力 ， 使 得 改 区 块 链 更 困难 ， 因 此 区 块 链 补 认 为 是 更 安全 的 。 当 几乎 同时 挖 出 两 个 区 块 时 ,我们 将 把 网 络 分 成 两 部 分 ， 在 两 个 不 同 
的 区 块 链 上 工作 ， 但 是 其 中 一 个 将 成 为 最 终 区 块 链 。 所 以 在 无 效 块 上 工作 的 网 络 是 在 无 效 块 上 挖 下 一 个 区 块 ， 结 果 是 网 络 算 力 损 
失 ， 因 为 算 力 用 在 了 没有 用 的 事情 上 。 网 络 的 两 个 部 分 很 可 能 用 比 平均 时 间 更 长 的 时 间 去 挖 下 一 个 区 块 ， 因 为 它们 损失 了 算 力 。 
所 以 ， 在 挖 出 下 一 个 区 块 之 后 ， 难 度 值 将 降低 ， 原 因 是 用 于 挖 区 块 的 时 间 比 平均 时 间 更 长 。 难 度 值 降 低 会 影响 整体 区 块 链 安全 。 
如 果 无 效 块 率 太 高 ， 将 在 很 大 程度 上 影响 区 块 链 安 全 。 


以 太 坊 用 ghost 协 议 解 决 无 效 块 市 来 的 安全 问题 。 以 太 坊 使 用 这 个 真实 ghost 协 议 的 一 个 修正 版 本 。ghost 协 议 仅仅 把 无 效 
块 添加 到 母 链 上 ， 掩 兰 了 安全 问题 ， 由 此 增加 了 区 块 链 的 整体 难度 值 ， 因 为 区 块 链 的 整体 难度 值 还 包括 无 效 块 的 难度 值 己 和。 但 
是 如 何 才能 人 在 不 产生 交易 冲突 的 情况 下 把 无 效 块 添加 到 母 链 中 呢 ” 事 实 上 ， 任 何 区 块 链 都 可 以 接纳 零 个 或 者 多 个 无 效 块 。 为 了 激 
励 矿 工 接 纳 无 效 块 ， 矿 工 接 纳 无 效 块 将 得 到 回报 。 此 外 ， 友 现 无 效 块 的 矿工 也 将 得 到 回报 。 无 效 块 中 的 交易 不 用 于 计算 确认 ， 无 
效 块 矿 工 也 不 向 无 效 块 接纳 的 交易 收取 交易 费 。 注 意 ， 在 以 太 坊 中 ， 无 效 块 称 为 “ 瓜 块 (uncle block) " , 


矿工 接纳 无 效 块 得 到 的 回报 计算 公式 如 下 。 其 余 回 报 归 侄 块 (nephew block) , BEIA (orphan block) 的 区 块 : 


(uncle block number + 8 - block number) * 5 / 8 


你 肯定 在 奇怪 为 什么 要 给 无 效 块 矿 工 回 报 。 即 便 不 给 它们 任何 回报 ， 也 不 会 影响 安全 。 这 是 因为 无 效 块 经 常 出 现在 网 络 中 会 
导致 男 一 个 问题 ， 而 这 个 问题 可 以 通过 给 无 效 块 矿 工 回 报 解决 。 矿 工 应 当 得 到 一 定 比 例 的 回报 ， 大 致 相当 于 它 为 网 络 贡 献 的 算 力 
比例 。 如 果 两 个 不 同 的 矿工 几乎 同时 控 出 一 个 区 块 ， 则 算 力 比较 大 的 矿工 控 出 的 区 块 更 有 可 能 被 添加 到 最 终 区 块 链 中 ， 因 为 该 矿 
工控 下 一 个 区 块 的 效率 会 比较 局 ， 所 以 小 矿工 将 失去 回报 。 如 果 无 效 块 比例 低 ， 融 不 是 大 问题 ， 因 为 大 矿工 增加 回报 的 概率 不 
大 。 但 是 ， 如 果 无 效 块 比 例 高 ， 残 会 产生 大 问题 ， 也 束 是 说 ， 大 矿工 在 网 络 中 最 终 将 得 到 比 它 应 得 的 更 多 的 回报 。ghost 协 议 通 
过 回报 无 效 块 矿 工 找到 平衡 。 由 于 大 矿工 不 拿 走 全 部 回报 ， 但 是 仍 比 它们 应 得 的 多 ， 我 们 不 能 对 无 效 块 矿 工 和 储 块 给 予 同等 回 
报 ， 而 是 给 得 少 一 点 。 前 面 的 公 陈 很 好 地 解决 了 问题 。 


ghost 协 议会 限制 一 个 侄 块 可 以 指向 的 无 效 块 思 数 ， 这 样 矿 工 不 会 只 控 无 效 块 并 使 区 块 链 生成 速度 变 慢 。 


所 以 一 旦 无 效 块 出 现在 网 络 中 ， 它 会 或 多 或 少 地 影响 网 络 。 无 效 块 出 现 得 越 频 繁 ， 网 络 受 到 的 影响 越 大 。 


在 节点 验证 区 块 链 友 生 冲突 时 ， 会 友 生 分 又 (forking) ， 也 束 是 说， 在 网 络 中 有 多 于 一 个 区 块 链 ， 且 每 个 区 块 链 由 一 些 矿 
工 验证 。 分 又 共有 三 种 : 普通 分 又 、 软 分 又 和 硬 分 叉 。 


普通 分 又 是 由 于 两 个 或 者 多 个 矿工 几乎 同时 友 现 了 一 个 区 块 引 起 的 暂时 冲突 。 如 果 一 个 难度 值 高 于 另 一 个 ， 冲 突 束 解决 了 。 


更 改 源 代码 可 能 引起 冲突 。 根 据 冲 突 类 型 ， 可 能 要 求 有 50% 以 上 算 力 的 矿工 升级 ， 也 可 能 要 求 所 有 矿工 升级 ， 以 解决 冲突 。 
要 求 有 50% 以 上 算 力 的 矿工 升级 以 解决 冲突 ， 叫 作 软 分 叉 ; 而 要 求 所 有 矿工 升级 以 解决 冲突 ， 叫 作 硬 分 又 。 软 分 叉 的 一 个 例子 
是 ， 如 果 更 新 源 代码 使 日 区 块 /交易 的 一 部 分 失效 ， 则 有 509% 以 上 算 力 的 矿工 升级 后 可 以 解决 ， 这 样 新 的 区 块 链 将 有 更 大 难度 
值 ， 最 后 被 整个 网 络 接受 。 硬 分 又 的 一 个 例子 是 ， 如 果 更 新 源 代码 是 为 了 更 改 对 矿工 的 回报 ， 则 全 部 矿工 需要 升级 以 解决 冲突 。 


以 太 坊 目 友 布 以 来 经 历 了 多 次 硬 分 又 和 软 分 叉 。 


2.9 创 世 区 块 


创 世 区 块 (genesis block) 是 区 块 链 中 的 第 一 个 区 块 ， 其 区 块 序号 是 0。 它 是 区 块 链 中 唯一 一 个 不 指 同 前 一 个 区 块 的 区 块 ， 
因为 没有 前 一 个 区 块 。 它 也 不 包含 交易 ， 因 为 还 没 产 生 任何 以 太 币 。 


只 有 网络 中 的 两 个 节点 有 相同 的 创 世 区 块 ， 它 们 才 会 彼此 配对 ， 也 就 是 说 ， 如 果 两 个 对 等 节点 有 相同 的 创 世 区 块 才 会 进行 同 
步 区 块 ， 否 则 它们 将 彼此 拒绝 。 不 同 的 创 世 区 块 有 较 高 难度 值 也 不 能 替代 难度 值 较 低 的 。 每 一 个 忆 点 生成 目 己 的 创 世 区 块 。 对 于 
不 同 的 网 络 ， 创 世 区 块 被 硬 编码 到 客户 站 里 。 


2.10 AAPM 


和 其 他 货币 一 样 ， 以 太 币 也 有 多 种 面值 。 其 面值 如 下 : 


- 1A X F=1000000000000000000 wei 
- 1A X R —1000000000000000 Kwei. 

- 1A X 1000000000000 Mwei. 

- 1A A 81000000000 Gwei。 

- 1ZAX r$ 21000000 Szabo. 

- 1 以 太 币 =1000 Finney. 

- 1 以 太 币 =0.001 Kether。 

1 以 太 币 =0.000001 Mether. 

1 以 太 币 =0.000000001 Gether。 


. 1 以 太 币 =0.000000000001 Tether. 


2.11 以太 坊 虚拟 机 


以 太 坊 虚拟 机 (Ethereum Virtual Machine, EVM) 是 以 太 坊 智能 合约 字 节 人 码 (byte-code) 的 执行 环境 。 网 络 中 的 每 个 
节 点 都 运行 EYM。 所 有 市 点 执行 使 用 EVM 指 向 智能 合约 的 全 部 交易 ， 因 此 它们 进行 同样 的 计算 ， 并 存储 同样 的 数值 。 只 进行 以 
太 币 转账 (查询 该 地 址 是 否 有 余额 并 相应 地 扣 蒜 ) 的 交易 也 需要 进行 一 些 计 算 。 


出 于 各 种 原因 ， 每 个 节点 执行 并 存储 最 终 状 态 。 例 如 ， 如 果 有 一 个 智能 合约 存储 参加 派对 的 每 个 人 的 姓名 和 细节 ， 只 要 增加 
新 的 人 ， 区 向 网 络 广播 新 的 交易 。 网 络 中 的 任何 古 点 想 要 展示 参加 派对 的 每 个 人 的 细节 ， 只 需 读 取 合约 的 最 终 状 态 即 可 。 


费用 矿 


每 个 交易 需要 在 网 络 中 进行 一 些 计算 和 存储。 因此 需要 有 交易 费 ， 否 则 整个 网 络 里 将 序 斥 着 垃圾 交易 ， 而 且 没 有 交 
7) 成 本 不 


工 束 没有 理由 在 区 块 中 接纳 交易 ， 它 们 将 开始 挖 空 区 块 。 每 个 交易 需要 的 计算 和 存储 量 有 所 不 同 ， 因 此 每 一 个 交易 的 交 
同 。 


Ona 即 字 节 码 VM 和 JIT-VM。 在 写本 书 时 ，JIT-VM 已 交付 使 用 ， 但 其 开发 仍 未 结束 。 在 两 种 情况 


下 ，Solidity 代 码 都 被 编译 成 字 节 码 。 在 JIT-VM 中 ， 字 节 码 编译 更 充分 。JIT-VM 比 字 节 码 VM 更 高 效 。 


2.12 gas 


gas (燃料 ) 是 计算 资源 的 计量 单位 。 每 一 个 交易 都 需要 包含 gas 上 限 和 为 每 个 gas 支 付费 用 的 单价 〈 即 每 次 计算 的 价格 ) 。 
矿工 可 以 选择 接纳 交易 和 收取 费用 。 如 果 交 易 使 用 的 gas 少 于 或 等 于 gas 上 限 ， 交 易 继 续 进 行 。 如 果 gas 总 数 超过 gas 上 限 ， 则 撞 
销 所 有 修改 ， 除 了 仍然 合法 且 矿 工 仍然 能 够 收 到 费用 (费用 计算 方法 是 可 以 消耗 的 gas 最 大 值 和 gas 价 格 相 乘 ) 的 交易 。 


矿工 决定 gas 价 格 ( 即 每 次 计算 的 价格 ) 。 如 果 交 易 gas 价 格 低 于 矿工 决定 的 gas 价 格 ， 矿 工 将 拒绝 挖 交 易 。gas 价 格 以 wei 
为 单位 。 所 以 如 果 gas 价 格 低 于 期 望 ， 矿 工 可 以 拒绝 将 交易 接纳 入 区 块 。 
a EVM 的 每 个 操作 都 被 分 配 了 一 个 数字 ， 用 以 表示 它 可 以 消耗 的 gas。 


交易 成 本 影响 一 个 账 尸 可 以 转账 给 另 一 个 账户 的 以 太 币 上 限 。 例 如 ， 如 果菜 个 账户 里 共有 5 个 以 太 币 ， 它 不 能 把 全 部 2 个 以 
太 币 转 入 其 他 账户， 因为 如 果 把 所 有 以 太 币 都 汇 走 ， 账 尸 丈 没有 余额 支付 交易 费 了 。 


如 果 交 易 调 用 一 个 合约 方法 ， 且 该 万 法 友 送 一 些 以 太 币 或 者 调用 一 些 其 他 合约 方法 ， 束 从 调用 合约 方法 的 账户 扣除 交易 费 。 


2.13 RWS DR 


PRENSA Ba, CREE WP PRR, KH CALA ste / KR, JPÉSUTERHUSSZA/DXIA. TERES 
要 连接 到 网 络 中 的 每 一 个 节点 ; 相反 ， 它 只 连接 到 几 个 其 他 节点 ， 这 些 证 点 再 连 接 到 另外 几 个 节操 。 按 照 这 个 万 式 ， 整 个 网 络 彼 
此 连接 。 


但 是 书 点 如 何 友 现 网 络 中 的 一 些 其 他 证 点 呢 ? 没 有 每 个 三 点 都 可 以 连接 到 的 中 央 服 务 器 ， 怎 么 交换 信息 呢 ? 以 太 坊 有 目 己 的 
节 氮 发 现 协议 可 用 于 解决 这 个 问题 ， 该 协议 以 Kadelima 协 议 为 基础 。 在 节点 发 现 协议 中 有 一 种 特殊 的 节点 ， 叫 作 Bootstrap ( 初 
始 局 动 ) 节点 。Bootstrap 节 点 保 仓 了 一 段 时 间 内 与 它们 连接 的 所 有 节点 的 列表 ， 但 其 本 身 不 保存 区 块 链 。 当 对 等 节点 连接 到 以 
太 坊 网 络 时 ， 它 们 首先 连接 到 Bootstrap 节 上 各 ，Bootstrap 证 点 分 享 在 刚才 事先 定义 的 时 间 里 连接 到 它们 的 对 等 节点 列表 。 然 后 
对 等 节点 与 对 等 节操 连接 并 同步 。 


可 以 有 多 种 以 太 坊 实例 ， 也 丈 是 说 ,不同 的 网 络 每 个 都 有 上 自己 的 网 络 ID。 两 种 主要 的 以 太 坊 网 络 是 主 网 和 测试 网 。 以 太 币 
在 主 网 上 交易 ， 而 测试 网 供 开 友人 员 进 行 测试 。 到 目前 为 止 , 我 们 已 经 学 习 了 关于 主 网 区 块 链 的 所 有 知识 。 


0 bootnode 是 以 太 坊 Bootsttap 节 点 最 热门 的 实现 。 如 果 用 户 想 使 用 自己 的 Bootsttap 节 点 ， 可 以 使 用 bootnode。 


2.14 Whlsper 和 Swarm 


Whisper 和 和 Swarm 分 别 是 去 中 心 化 的 通信 协议 和 和 存储 平台 ， 它 们 都 由 以 太 坊 开 友 人 员 开 友 的 。Whisper 是 一 个 去 中 心 化 的 通 
信 协 议 ，Swarm 则 是 一 个 去 中 心 化 的 文件 系统 。 


Whisper 人 允许 网 络 中 的 节点 彼此 通信 。 它 支持 广播 、 用 户 到 用 户 、 加 密 信息 等 ， 但 不 用 于 传输 大 数据 。 想 更 深入 学 习 
Whisper， 请 访问 https://github.com/ethereum/wiki/wiki/Whisper,， 
在 https://github.com/ethereum/wiki/wiki/Whisper-Overview 可 以 看 到 代码 示例 概述 。 


Swarm 类 似 于 Filecoin， 二 者 最 大 的 区 别 是 撤 术 细 世 和 激励 机 制 。Filecoin 不 惩罚 存储; 而 Swarm 惩罚 存储 。 因 此 ， 这 进 一 
步 提 高 了 文件 可 用 性 。 那 么 ，Swarm 中 的 激励 机 制 如 何 工 作 ?” 它 有 内 部 货币 吗 ?” 事 实 上 ，Swarm 没 有 内 部 货币 ， 而 是 用 以 太 币 
进行 激励 。 在 以 太 坊 中 有 智能 合约 ， 智 能 合约 记录 激励 情况 。 显 然 ， 智 能 合约 不 能 与 Swarm 通信 ， 但 Swarm 能 与 智能 合约 通 
言 。 所 以 用 户 基本 上 通过 智能 合约 向 仓储 付款 ， 该 文 付 在 失效 后 被 释放 给 存储。 用 户 还 可 以 向 智能 合约 报 失 文件 ， 在 此 情况 下 它 


np. nLbhttps://github.com/ethersphere/go-ethereum/wiki/IPFS-&-SWARM 7 fftSwarmstlPFS/Filecoin 
之 间 的 区 别 ， 访 问 https://github.com/ethersphere/go-ethereum/blob/bzz-config/bzz/bzzcontract/swarm.sol 查 看 智能 
合约 代码 。 


在 写本 书 时 ，Whisper 和 swarm 仍 处 于 开 上 友 阶 段 ， 许 多 事情 仍 不 明确 。 


2.15 geth 


geth (或 称 为 go-ethereum) 是 以 太 坊 、Whisper 和 Swarm 节点 的 一 个 实现 。geth 可 以 成 为 全 部 实现 或 者 一 些 选 定 实现 的 
一 部 分 。 合 并 它们 的 目的 是 让 它们 看 起 来 像 单一 的 DApp， 通 过 一 个 节点 客户 端 就 可 以 访问 三 个 DApp。 


geth 是 一 种 CLI 应 用 ， 它 用 Go 语言 编写 ， 在 主要 的 操作 系统 中 都 可 使 用 。geth 的 当前 版 本 还 不 支持 Swarm， 但 支持 
Whisper 的 一 些 功 能 。 在 写本 书 时 ，geth 的 最 新 版 本 是 1.3.5。 


2.15.1 zz3geth 


geth 可 用 于 OS X, Linux#]Windows#R/FAS. Cita: 二 进 制 安 委 和 脚本 安装 。 在 写本 书 时 ，geth 的 最 
新 版 本 是 1.4.13。 让 我 们 看 看 如 何 使 用 二 进 制 安 委 方法 在 不 同 操作 系统 中 进行 安 疼 。 如 果 用 户 不 得 不 修改 geth 源 代码 并 安 疼 ， 请 
使 用 脚本 安 委 方法 。 我 们 不 想 改 变 源 代码 ， 因 此 将 采用 二 进 制 安 和 。 


1.OS X 
推荐 在 OS XrhfssRdbrewszzgeth, Eimar MAPA T ap geth: 


brew tap ethereum/ethereum 
brew install ethereum 


2.Ubuntu 


推荐 在 Ubuntu 中 使 用 apt-get 安 装 geth。 在 Ubuntu 终端 中 运行 如 下 命令 安装 geth : 


sudo apt-get install software-properties-common 
sudo add-apt-repository -y ppa:ethereum/ethereum 
sudo apt-get update 

sudo apt-get install ethereum 


3.Windows 


WFWindowskin, gethzé—" HJ Xt. Mhttps://github.com/ethereum/go-ethereum/wiki/Installation- 
instructions-for-Windows 下 载 zip 文 件 ， 并 解压 缩 。 压 缩 包 中 有 geth.exe 文 件 。 


© 想 更 多 地 了 解 在 不 同 操作 系统 上 安装 geth 的 方法 ， 请 访问 https://github.comy/etheteumygo-etheteumy/wiki/Building- 


Ethereum. 


2.15.2 JSON-RPC 和 Javascript 操 作 台 


geth 为 其 他 应 用 提供 了 与 其 进行 通信 的 JSJON-RPC API。geth 使 用 HTTP、Websocket 和 其 他 协议 服务 于 JSON-RPC API, 
JSONRP<C 提 供 的 API 分 成 : admin、debug、eth、miner、net、personal、shh、txpool 和 web3 等 类 型 。 访 
问 https://github.com/ethereum/go-ethereum/wiki/JavaScript-Console 可 以 了 解 更 多 信息 。 


geth 还 提供 了 一 个 交互 Javascript 操 作 台 ， 可 以 使 用 Javascript APlI 进 行程 序 交 互 。 该 交互 操作 人 台 使 用 JSON-RPC 与 geth 进 
行 通 信 。 在 后 面 的 章节 中 ， 我 们 将 学 习 更 多 关于 JSON-RPC 和 Javascript API 的 内 容 。 


2.15.3 ap ST lu 

让 我 们 通过 例子 学 习 geth 命 令 的 一 些 重 要 的 子 命令 和 选项 。 用 户 可 以 使 用 help 子 命令 上 友 现 所 有 子 命令 和 选项 的 列表 。 我 们 
将 在 下 面 学 习 更 多 天 于 geth 及 其 命令 的 知识 。 

1. 连 接 至 主 网 网 络 

以 太 坊 网 络 中 的 节点 默认 用 30303 端 口 通信 。 但 是 节点 还 可 以 收听 一 些 端口 。 


为 了 连接 到 主 网 网 络 ， 只 需要 运行 geth 命 令 即 可 。 如 下 是 一 个 例子 ， 展 示 如 何 明确 指定 网 络 ID 和 指定 将 存储 下 载 区 块 链 的 
目 定义 目录 : 


geth --datadir "/users/packt/ethereum" --networkid 1 
其 中 ，--datadir 选 项 用 于 指定 在 哪里 仓储 区 块 链 。 如 果 没有 提供 ， 默 认 路 径 是 “$HOME/.ethereum ” ; 
--networkid 用 于 指定 网 络 ID。1 代 表 主 网 网 络 ID。 如 果 没 提供 网 络 ID， 默 认 值 是 1。2 代 表 测 试 网 络 ID。 
2. 创 建 私有 网 络 


要 创建 私有 了 网络， 只 需 给 出 一 个 随机 网 络 ID 即 可 。 通 单 创建 私有 网 络 的 目的 是 进行 开 友 。geth 还 提供 了 多 个 与 日 志和 调试 
相关 的 标记 (flag) ， 这 对 于 开发 很 有 益处 。 可 以 简单 使 用 --dev 标 记 运 行 一 个 私有 了 网络， 该 网 络 允 许多 个 与 日 志和 调试 相关 的 
标记 ， 而 不 用 给 出 一 个 随机 网 络 ID 并 放 上 多 个 与 日 志和 调试 相关 的 标记 。 


2.15.4 创建 账户 


geth 还 允许 创建 账户 ， 即 生成 密 钥 和 相关 地 址 。 为 了 创建 账户 ， 可 以 使 用 下 面 的 命令 : 


geth account new 


Seaham, BABBLER. WR Ice, MAAK T 


为 了 在 本 地 钱包 获得 所 有 账户 的 列表 ， 可 以 使 用 下 面 的 命令 : 


geth account list 


执行 上 述 命令 将 打印 账户 中 所 有 地 址 的 列表 。 密 钥 默 认 存 储 在 --datadir 路 径 中 ， 但 用 户 可 以 使 用 --keystore 选 项 指定 一 个 
不 同 的 目录 。 


默认 geth 不 局 动 挖 矿 。 为 了 指示 geth 开 始 控 矿 ， 只 需要 提供 --mine 选 项 。 还 有 一 些 与 控 矿 相关 的 选项 : 


geth --mine --minerthreads 16 --minergpus '0,1,2' --etherbase 
'489b4e22aab35053ecd393b9f9c35f4Aflde7b194' --unlock 
'489b4e22aab35053ecd393b9f£9c35f£4f1de7b194' 


除了 --mine 选 项 之 外 ， 这 里 还 给 出 了 其 他 选项 。--minerthreads 选 项 用 于 指定 哈 希 过 程 中 使 用 的 线程 总 数 ， 默 认 使 用 8 个 线 
程 。etherbase 是 挖 矿 赚 取 的 回报 存 入 的 地 址 。 账 尸 默认 是 加 密 的 。 所 以 要 访问 账户 中 的 以 太 币 ， 残 需要 解锁 ， 即 解码 账户 。 解 
密 用 于 解码 账 尸 相关 私 铀 。 为 了 开始 挖 矿 ， 不 需要 解锁 它 ， 因 为 只 需要 地 址 融 能 仓 入 挖 矿 回报 。 可 以 使 用 -unlock 选 项 解锁 一 个 
或 者 多 个 账户 。 使 用 逗号 分 隔 地 址 可 以 提供 多 个 地 址 。 


--minergpus 用 于 指定 挖 矿 使 用 的 GPU。 为 了 得 到 GPU 列表 ， 可 以 使 用 geth gpuinfo 命 令 。 每 个 GPU 需要 1 ~ 2GB 的 
RAM。 黑 认 只 使 用 CPU， 而 不 使 用 GPU。 


2. 快 速 同 步 


在 写本 书 时 ， 区 块 链 大 小 大 约 为 30GB。 如 果 用 户 的 网 速 慢 ， 则 下 载 需 要 化 费 几 个 小 时 甚至 几 天 。 以 太 坊 实现 了 一 种 快速 同 
步 算法 ， 可 以 更 快 地 下 载 区 块 链 。 


快速 同步 (fast synchronization) 不 下 载 整个 区 块 ， 而 只 下 载 区 块头 、 交 易 赁 证 和 最 新 的 状态 数据 库 。 因 此 用 户 不 需要 下 
载 和 重播 全 部 交易 。 为 了 检查 区 块 链 的 真实 性 ， 该 算法 在 每 一 个 已 定义 的 区 块 序号 之 后 下 载 一 个 完整 的 区 块 。 要 更 深入 地 学 习 快 
速 同步 算法 ， 请 访问 https://github.com/ethereum/go-ethereum/pull/1889。 


为 了 在 下 载 区 块 链 过 程 中 使 用 fast sync， 用 户 需 要 在 运行 geth 的 过 程 中 使 用 --fast。 


出 于 安全 原因 ，fast sync 只 在 初始 同步 时 运行 ( 即 该 节点 上 自身 的 区 块 链 为 空 时 ) 。 在 节点 成 功 与 网 络 同步 后 ，fast sync 
永远 蔡 用 了 。 作 为 一 项 额外 的 安全 功能 ， 如 果 在 枢 轴 点 (pivot point) 附近 或 者 之 后 快速 同步 失败 ， 束 会 禁用 fast sync， 然 后 
太 尽 返回 到 完整 的 、 以 区 块 处 理 为 基础 的 同步 。 


2.16 ”以 太 坊 钱包 


以 太 坊 钱 包 是 一 个 以 太 坊 Ul 客 尸 端 ， 它 允许 用 尸 进行 创建 账 尸 、 友 送 以 太 币 、 部 署 合约 、 调 用 合约 万 法 等 操作 。 


以 太 坊 钱 包 与 geth 捆 缕 在 一 起 。 运 行 以 太 坊 时 ， 它 会 尝试 友 现 一 个 本 地 geth 实 例 并 与 之 连接 ; 如 果 它 不 能 友 现 geth 正 在 运 


行 ， 它 就 启动 自己 的 geth 节 点 。 以 太 坊 钱 包 使 用 IPC 与 geth 通 信 。geth 支 持 以 文件 为 基础 的 IPC。 


省 如 果 在 运行 geth 时 更 改 数据 目录 ， 就 是 也 在 更 改 IPC 文 件 路 径 。 所 以 为 了 让 以 太 坊 钱包 发 现 并 连接 到 geth 实 例 ， 需 要 使 
用 --ipcpath 选 项 指定 IPC 文 件 位 置 为 其 默认 位 置 ， 这 样 以 太 坊 钱包 可 以 发 现 它 ; 否则 ， 以 太 坊 钱包 就 不 能 发 现 它 ， 将 启动 自己 的 


geth 实 例 。 为 了 发 现 默 认 IPC 文 件 路 径 ， 运 行 geth help， 它 会 显示 --ipcpath 选 项 的 默认 路 径 。 


请 访问 https://github.com/ethereum/mist/releases 下 载 以 太 坊 钱包 。 它 适用 于 Linux、OS X 和 Windows 操 作 系 统 。 与 
geth—ff, CEMRE: it sSNA, 


以 太 坊 钱包 的 示意 图 如 图 2-1 所 示 。 


2.17 ase 
浏览 器 钱包 (Mist) 是 以 太 坊 、Whisper 和 Swarm 的 一 个 客户 端 ， 它 允许 用 户 发 送 交易 、 发 送 Whisper 信 息 、 检 查 区 块 链 


Mist 各 geth 之 | 则 的 天 系 类 似 于 以 太 坊 钱包 和 geth.。 


Mist 最 热门 的 功能 是 它 带 有 浏览 器 。 目 前 ， 浏 览 器 中 运行 的 前 端 Javascript 可 以 使 用 web3.js 库 (该 库 为 其 他 应 用 提供 以 太 
坊 操作 台 的 Javascript AP 与 geth 通 信 ) 访问 geth 节 点 的 web3 API, 


Mist 的 基本 思想 是 创建 第 三 代 Web (Web 3.0) ， 即 使 用 以 太 坊 、Whisper 和 Swarm 蔡 代 中 心 化 服务 器 端 ， 这 样 束 不 需要 
Bos eeu f. 
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Accounts Overview 


Accounts are password protected keys that can hold ether, secure ethereum-based tokens or coins and control contracts. Accounts can't 


display incoming transactions. 
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Q 700. @ 000 @ o». 
£ ACCOUNT 5 


@ oo. 


ADD ACCOUNT 


WALLET CONTRACTS 


These are contracts that are stored on the blockchain and can hold and secure ether. They can have multiple accounts as owners and keep a 


full log of all transactions. 


4 ADD WALLET 
CONTRACT 


LATEST TRANSACTIONS 


Sep Transfer between accounts 


26 * Account5 > e Main account (Etherbase) 


Sep Transfer between accounts 


26 2 Account 5 > ux Account 5 


Sep Transfer between accounts 


26 * Account5 > € Account 3 


图 2-1 ”以太 坊 钱包 的 示意 图 


Mist 的 示意 图 如 图 2-2 所 示 。 


2.18 ”以 太 坊 的 缺 操 
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CONTRACTS 
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为 基础 的 应 用 一 样 面 | 


1.Sybil 攻 击 


攻击 者 可 能 试图 用 他 控制 的 普通 节点 占 满 整个 网 络 ， 那 么 用 户 很 有 可 能 只 连接 到 攻击 者 节操 。 





鱼 着 DoS 攻 击 。 让 我 们 看 看 以 太 坊 独 有 的 且 最 重要 的 缺 后 。 


一 旦 连接 到 攻击 者 节点 ， 攻 击 


者 可 以 拒绝 从 所 有 节操 转播 区 块 和 交易 ， 从 而 将 用 尸 从 网 络 中 断 开 。 攻 击 者 只 能 转播 他 创建 的 区 块 ， 从 而 会 将 用 尸 放 到 分 开 的 网 


络 上 。 


Mist 
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Block number: 1319 (Size: 311.00 B) 
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图 2-2 Mist 的 示意 图 
2.51% 攻 击 


如 果 攻 击 者 掌握 了 网 络 中 一 半 以 上 的 算 力 ， 他 融 可 以 比 网 络 中 其 他 人 更 快 地 生成 区 块 。 攻 击 者 可 以 保留 他 的 私有 分 又 ， 直 到 
分 叉 比 减 实 网 络 创造 得 更 长 ， 然 后 广播 自己 的 分 


拥有 50% 以 上 的 算 力 ， 矿 工 束 可 以 重 写 交易 ， 阻 止 全 部 /一 些 交 易 被 挖 出 ， 并 阻止 其 他 矿工 挖 出 的 区 块 被 添加 a 到 区 块 链 中 。 


2.19 serenity 


serenity 是 以 太 坊 下 一 个 主要 更 新 的 名 字 。 在 写本 书 之 时 ，serenity 仍 处 于 开 友 阶段 。 这 个 更 新 将 要 求 硬 分 又 。serenity 把 
共识 协议 改 为 casper， 并 将 整合 状态 通道 和 分 片 。 在 写本 书 时 ， 完 整 细 市 尚 不 明确 。 


1. 文 付 和 状态 通 填 


在 学 习 状 态 通道 以 前 ， 我 们 需要 了 解 驻 付 通 道 的 概念 。 文 付 通 道 功 能 允许 将 两 个 以 上 辐 另 一 个 账户 友 送 以 太 币 的 交易 合并 成 
两 个 交易 。 其 工作 原理 为 : 假设 X 是 一 个 视频 网 站 老板 ，Y 是 个 用 户 。X 每 分 钟 收费 1 个 以 太 币 。 现 在 X 想 让 Y 看 视频 期 间 每 分 钟 区 
一 次 钱 。 当 然 ，Y 可 以 每 分 钟 三 播 交 易 ， 但 是 这 里 还 有 将 问题 ， 例 如 X 不 得 不 等 竺 确认， 所 以 视频 融会 中 断 一 会 。 文 付 通 道 可 以 
解决 这 个 问题 。 使 用 文 付 通道 ，Y 可 以 广播 一 个 锁定 交易 ， 为 X 把 一 些 以 太 币 (比如 100 个 以 太 币 ) 锁定 一 段 时 间 (比如 24 小 
HJ) 。 现 在 每 看 完 一 分 钟 视频 ，Y 将 友和 送 一 个 丛 名 记录 表示 可 以 解锁 ， 一 个 以 太 币 融 进 入 X 的 账户， 其 余 的 进入 Y 的 账 尸 。 再 过 


DE, YTEAXE— T SAIDGEGURHILARESBÓ PASAT ROEAXAUIK, EZRBSERAYBSNKPS. YXXREPXPDRABSSUADSRECR, iX 
过 程 将 持续 。 现 在 假设 Y 看 完了 100 小 时 视频 或 者 24 小 时 时 间 到 了 ，X 将 向 网 络 广播 最 后 的 釜 名 记录 ， 以 把 钱 收 到 目 己 的 账户 
里 。 如 果 X 没 有 在 24 小 时 内 提 款 ， 全 款 会 返还 给 Y。 所 以 在 区 块 链 中 ， 我 们 将 看 到 lock 和 unlock 两 种 交易 。 


支付 通道 是 与 友 送 以 太 币 相关 的 交易 。 类 似 地 ， 状 态 通 道 允 许 合 并 与 智能 合约 相关 的 交易 。 
2. 权 益 证 明和 casper 
在 学 习 casper 共 识 协议 之 前 ， 我 们 需要 理解 权益 证 明 (Proof-of-Stake, PoS) 共识 协议 的 工作 原理 。 


权 葵 证 明 是 工作 量 证 明 最 常见 的 替代 共识 。 工 作 量 证 明 会 瀛 费 大 量 算 力 。PoW 和 PoS 之 间 的 区 别 丈 是 : Posh, S 工 不 需 
要 解决 问题 ; 而 在 Pow 中 ， 矿 工 需 要 证 明 挖 矿 权益 的 所 有 权 。 在 PoS 系 统 中 ， 账 户 中 的 以 太 币 被 当 作 权 益 ， 矿 工控 矿 的 概率 与 矿 
工 持 有 的 权益 成 正比 。 所 以 如 果 矿 工 拥有 网络 中 10% 的 权益 ， 它 将 挖 到 10% 的 区 块 。 


但 问题 是 怎样 才能 知道 谁 将 挖 下 一 个 区 块 。 我 们 不 能 简单 地 让 持 有 最 多 权益 的 矿工 忌 能 挖 出 下 一 个 区 块 ， 因 为 这 将 导致 中 心 
化 。 对 于 下 一 个 区 块 的 选择 ， 存 在 不 同 的 算法 ， 例 如 随机 区 块 选择 和 基于 币 龄 的 选择 。 


casper 是 PoS 的 一 个 修订 版 本 ， 它 解决 了 PoS 中 的 一 些 问题 。 
3.53 


目前 ， 每 个 节操 都 需要 下 载 全 部 交易， 数量 庞大 。 按 照 现 在 区 块 链 发 展 的 速度 ， 未 来 用 不 了 几 年 ， 下 载 整个 区 块 链 并 同步 将 
是 非常 困难 的 。 


如 果 用 户 熟悉 分 布 式 数据 库 架 构 ， 那 么 肯定 熟悉 分 片 (sharding) 。 简 言 之 ,分 片 就 是 在 多 个 计算 机 分 布 数据 的 方法 。 以 
太 坊 将 实现 分 片 ， 以 分 割 区 块 链 并 跨 节点 分 布 区 块 链 。 


读者 可 以 在 https://github.com/ethereum/wiki/wiki/Sharding-FAQ 学 习 将 区 块 链 分 片 的 知识 。 


2.20 I 


在 本 章 中 ， 我 们 具体 学 习 了 以 太 坊 的 工作 原理 、 区 块 时 间 如 何 影响 安全 以 及 以 太 坊 的 缺点 ; 还 学 习 了 Mist 和 以 太 坊 钱包 的 概 
念 及 其 安装 方法 ， 以 及 geth 的 一 些 重要 命令 ; 最 后 学 习 了 以 太 坊 setenity 更 新 中 的 新 内 容 。 


在 下 一 章 中 ， 我 们 将 学 习 存 储 和 保护 以 太 币 的 不 同方 法 。 


Bie ”编写 智能 合约 


在 前 一 章 中 ， 我 们 学 习 了 以 太 坊 区 块 链 的 工作 原理 以 及 PoW 共 识 协 议 保 障 其 安全 性 的 原理 。 现 在 我 们 已 经 掌握 了 以 太 坊 的 
工作 原理 ， 所 以 是 时 候 开始 编写 智能 合约 了 。 有 好 几 种 语言 可 以 用 于 编写 以 太 坊 智能 合约 ， 不 过 solidity 是 最 热门 的 语言 。 在 本 
章 中 ， 我 们 将 首先 学 习 Solidity 编 程 语言 。 然 后 创建 一 个 DApp， 用 于 证 明 在 特定 时 | 间 的 存在 、 和 真实 性 和 所 有 权 ， 即 证 明 一 个 文 


件 在 一 个 特定 时 间 属 于 一 个 特定 所 有 者 。 
在 本 草 中 ， 我 们 将 讲解 以 下 内 容 : 
Solidity 源 文件 的 布局 。 
理解 Solidity 的 数据 类 型 。 
: 合约 的 特殊 变量 和 函数 。 
+ 控制 结构 。 
合约 的 结构 和 功能 。 


+ 编译 和 部 着 合约 。 


3.1 Solidity 源 文件 


Solidity 源 文件 使 用 的 扩展 名 为 .sol。 与 其 他 编程 语言 一 样 ，Solidity 有 多 种 版 本 。 在 写本 书 时 ， 其 最 新 版 本 是 0.4.2。 


在 源 文件 中 ， 可 以 使 用 pragma Solidity 说 明 编 写 代码 时 用 的 编译 器 版 本 。 例 如 ， 


pragma Solds1dity ^0.42.23 


现在 ， 源 文件 不 会 用 低 于 0.4.2 的 编译 器 和 版本， 也 不 会 用 高 于 0.5.0 的 编译 器 版 本 进行 编译 (第 二 个 条 件 使 用 ^ 添 加 ) . 0.4.2 
和 0.5.0 之 间 的 编译 器 版 本 最 有 可 能 包括 bug 修 复 。 


o 可 以 为 编译 器 版 本 指定 更 复杂 的 规则 ; R7] E5npm—4£E 89 GA Xe 


3.2 ”智能 合约 的 结构 


BARRE (cass) ， 其 中 包含 状态 变量 (state variable) , wax (function) 、 遂 数 修 改 器 (function 
modifier) 、 事 件 (event) 、 结 构 (structure) 和 枚 举 (enum) 。 合 约 还 支持 继承 ， 通 过 在 编译 时 备份 代码 来 实现 。 最 后 ， 


合约 还 支持 多 人 态 。 


下 面 来 看 一 个 智能 合约 的 例子 : 


contract Sample 


{ 
//state variables 
uint256 data; 
address owner; 


//event definition 
event logData(uint256 dataToLog) ; 


//function modifier 
modifier onlyOwner() { 
if (msg.sender != owner) throw; 


— f 


j 


//constructor 

function Sample(uint256 initData, address initOwner) { 
data = initData; 
owner = initOwner; 


j 


/ / functions 


function getData() returns (uint256 returnedData) { 
return data; 


j 


function setData(uint256 newData) onlyOwner{ 
logData (newData); 
data = newData; 


上 述 代码 的 工作 原理 如 下 : 
1) 使 用 contract 关 键 字 声明 一 个 合约 。 


2) 声明 两 个 状态 变量 data 和 owner。data 包 含 一 些 数据 ，owner 包 含 所 有 者 的 以 太 坊 钱包 地 址 ， 即 部 署 合 约 者 的 以 太 坊 地 


址 。 


~~ 


3) 定义 一 个 事件 (event) 。 事 件 用 于 通知 客户 端 。 一 旦 data 发 生变 化 ， 将 触发 这 个 事件 。 所 有 事件 都 保存 在 区 块 链 中 。 


~~ 


4) EX- TRA Zan (function modifier) 。 修 改 器 用 于 在 执行 一 个 消 数 之 前 目 动 检测 条 件 。 这 里 ,修改 器 检测 合约 所 
有 者 是 人 否 在 调用 函数 。 如 果 不 是 ， 束 抛 出 异 弟 。 


~~ 


5) 得 到 合约 构造 函数 (constructor) 。 在 部 署 合 约 时 ， 调 用 构造 函数 。 构 造 国 数 用 于 初始 化 状态 变量 。 
6) 定义 两 个 方法 。 第 一 个 方法 用 于 得 到 data 状 态 变量 的 值 ， 第 二 个 方法 用 于 改变 data 的 值 。 


在 更 深入 地 学 习 智 能 合约 的 消 数 之 前 ， 我 们 先 来 学 习 一 些 与 Solidity 有 关 的 其 他 知识 ， 然 后 表 回 到 合约 。 


RR HK. ufixedOx8, ufixedO0x16, 


Jg, fixedO0x8, fixedOx16, 


数组 类 型 


Solidity 支 持 generic 和 byte 两 种 数组 


3.3 ”数据 位 置 
内 存 和 文件 系统 中 ， 


HAIA 


KRÆ W 


截至 目前 ,我 们 学 过 的 所 有 编程 语言 可 能 都 把 变量 存储 在 内 存 中 。 但 是 在 Solidity 中 ， 根 据 情况 的 不 同 ， 变 量 可 能 不 存储 在 


根据 情况 的 不 同 ， 数 据 总 有 一 个 默认 位 置 。 但 是 对 于 复杂 数据 类 
(struct) ， 可 以 用 向 
storage。 显 然 ， 对 于 状 


KAJ 
Aan 


IL 


， 例 如 字符 串 (string) 、 数 组 (array) 和 结构 类 型 
加 storage 或 者 memory 进 行 重 写 。 六 数 参 数 (包括 返回 参数 ) 默认 用 memory， 本 地 变量 默认 用 
态 变量 来 说 ， 位 置 强 制 用 storage。 
数据 位 置 很 重要 ， 因 为 它们 会 改变 分 配 的 行为 : 


杂 类 型 ， 则 不 创建 备份 。 


stotape 变 量 和 memoty 变 量 之 间 的 分 配 总 是 创建 一 个 独立 的 备份 。 但 如 果 分 配 是 从 memoty 存 储 的 一 种 


到 一 个 状态 变量 的 分 配 〈 即 使 是 来 目 其 他 状态 变 


RE) 总 是 创建 一 个 独立 的 备份 。 
不 能 把 memoty 中 存储 的 复杂 类 型 分 配给 本 地 存储 变量 。 
(EA BORA XS 


量 给 本 地 存储 变量 的 情况 下 ， 本 地 存储 变量 指向 状 


DN 


AS 


变量 ， 也 就 是 说 ， 本 地 存储 变量 变 


为 指针 。 


3.4 ”什么 是 不同 的 数据 类 型 


Solidity 是 一 种 静态 类 型 语言 ， 变 量 存 储 的 数据 


类 型 需 


wo EA 


* J& [8] 


要 预先 定义 。 所 有 变量 默认 值 都 是 0。 在 Solidity 中 ， 
现在 让 我 们 看 看 Solidity 提 供 的 不 同 数据 类 型 : 
单 的 数据 类 


ATR EH 
Ac EB XE 


HERS, tile, ERREA aN SNe BEAR COS GE, Acc eee RAN. 


国 数 作 
是 布尔 值 ， 可 以 是 true 或 者 false。 


uint8, uintl6, uint24, 


ELM 


，uint256 分 别 用 于 存储 无 符号 
，int256 分 别 用 于 存储 8 位 ，16 位 ，24 位 ， 
AZ 


BAÈ, 1642, 2443, 


, 2564z AK. FP, int8, int16, 
，256 位 整数 。uint 和 int 是 uint256 和 int256 的 别名 。 类似 于 uint 和 int，ufixed 和 fixed 代 
，ufixed0x256 分 别 用 于 存储 未 签名 的 8 位 ，16 位 ，24 位 ， 
，fixed0x256 分 别 用 于 存储 8 位 ，16 位 ，24 位 ， 

位 数据 类 型 存储 该 数字 的 近似 值 。 


，250 位 分 数 。 同 


，256 位 分 数 。 如 果 一 个 数字 超过 256 位 ， 则 使 用 256 
address J 以 用 于 存储 最 大 20 字 节 的 值 (十 六 进 制 表示 ) 。 它 用 于 存储 以 太 坊 地 址 。addtess 类 型 有 两 个 属性 : balance 和 


send。balance 用 于 检测 地 址 余额 ，send 用 于 向 地 址 发 送 以 太 币 。send 方 法 拿 出 需要 转账 那些 数量 的 wei， 并 根据 转账 是 否 成 功 返 回 
true 或 者 false。wei 从 调用 send 方 法 的 合约 中 扣除 。 用 户 可 以 在 Solidity 中 使 用 0x 前 


级 给 变 


配 一 个 十 六 进 制 的 数值 。 


类 型 。 


它们 支持 固定 长 度 和 动态 长 度 两 种 数组 ， 也 支持 多 维 数组 。 


bytes1, bytes 2, bytes3, ...... ，bytes32 是 字 节 数组 的 类 型 。byte 是 bytes 1 的 别名 。 
下 面 给 出 了 generic 数 组 语法 的 一 个 示例 : 


contract sample{ 

//dynamic size array 

//wherever an array literal is seen a new array is created. If the 
array literal is in state than it's stored in storage and if it's found 
inside function than its stored in memory 

//Here myArray stores [0, 0] array. The type of [0, 0] is decided based 
on its values. 

//Therefore you cannot assign an empty array literal. 

int[] myArray = [0, 0]; 


function sample(uint index, int value) { 


//index of an array should be uint256 type 
myArray[index] = value; 


//myArray2 holds pointer to myArray 
int[] myArray2 = myArray; 


//a fixed size array in memory 

//here we are forced to use uint24 because 99999 is the max value 
and 24 bits is the max size required to hold it. 

//This restriction is applied to literals in memory because memory 
is expensive. As [1, 2, 99999] is of type uint24 therefore myArray3 also 
has to be the same type to store pointer to it. 

uint24[3] memory myArray3 = [1, 2, 99999]; //array literal 


//throws exception while compiling as myArray4 cannot be assigned 
to complex type stored in memory 


uint8[2] myArray4 = [1, 2]; 
} 
} 
关于 数组 的 重要 内 容 如 下 : 


- 数组 还 有 length 属 性 ， 用 于 发 现 数组 的 长 度 。 用 户 还 可 以 给 lenpgth 属 性 分 配 一 个 值 ， 以 改变 数组 大 小 ， 但 不 可 以 在 内 存 中 改 
变数 组 大 小 ， 也 不 可 以 改变 非 动 态 数组 大 小 。 


- 如 果 想 访问 动态 数组 的 未 设置 索引 (unsetindex) ， 会 抛 出 异常 。 


0 记 住 : attay、sttucts 和 mab 都 不 可 以 用 作 函 数 参 数 ， 也 不 可 以 用 作 函 数 返回 值 。 


34.2 ”字符 串 类 型 


在 Solidity 中 ， 有 两 种 方法 创建 字符 串 : 使 用 bytes 和 string。bytes 用 于 创建 原始 字符 串 ， 而 string 用 于 创建 UTF-8 字 符 串 。 
字符 捉 长 度 忌 是 动态 的 。 


下 面 给 出 了 字符 串 语法 的 一 个 示例 : 


contract sample{ 

//wherever a string literal is seen a new string is created. If the 
string literal is in state than it's stored in storage and if it's found 
inside function than its stored in memory 

//Here myString stores "" string. 

Strang myString = Ty /7string Lateral 

bytes myRawString; 


function sample(string initString, bytes rawStringInit) { 
myString = initString; 


//myString2 holds a pointer to myString 
String myString2 = myString; 


//myString3 is a string in memory 
string memory myString3 = "ABCDE"; 


//nere the length and content changes 
myString3 = "XYZ"; 


myRawString = rawStringInit; 


//incrementing the length of myRawString 
myRawString.length+tt+; 


//throws exception while compiling 
string myString4 = "Example"; 


//throws exception while compiling 
string myString5 = initString; 


3.4.3 ”结构 类 型 


Solidity 还 支持 结构 类 型 (struct) 。 下 面 给 出 了 struct 语 法 的 一 个 示例 : 


contract sample{ 

struct mysStructb + 

bool myBool; 
String myotrings 

myStruct s1; 

//wherever a struct method is seen a new struct is created. If the 
struct method is in state than it's stored in storage and if it's found 
inside function than its stored in memory 

myStruct s2 = myStruct(true, ""); //struct method syntax 


function sample(bool initBool, string initString) { 


//create a instance of struct 


sl —mvSULIDOCLirnrtBoOl, ZinitStErimng)j; 


//myStruct (initBool, initString) creates a instance in memory 
myStruct memory s3 = myStruct(initBool, initString); 


Q.. 函数 参数 不 可 以 是 结构 类 型 ， 且 函数 不 可 以 返回 结构 类 型 。 


3.44 ” 枚 举 类 型 


solidity 还 广 持 枚 举 类 型 (enum) 。 下 面 给 出 了 enum 语 法 的 一 个 示例 : 
contract sample { 

//The integer type which can hold all enum values and is the smallest 
is chosen to hold enum values 

enum OS ( Windows, Linux, OSX, UNIX } 

OS choice; 

function sample(OS chosen) { 


choice = chosen; 


function setLinux0OS () { 
choice = OS.Linux; 


function getChoice() returns (OS chosenOS) { 
return choice; 


3.4.5 mapping 类 型 


mapping 数 据 类 型 是 一 个 哈 希 表 。mapping 类 型 只 可 以 存在 于 storage 中 ， 不 存在 于 memory 中 ， 因 此 它们 是 作为 状态 变量 
声明 的 。 可 以 认为 mapping 类 型 包 合 key/value 对 ， 不 是 实际 存储 key， 而 是 存储 key 的 keccak256 哈 希 ， 用 于 查询 value。 
mapping 类 型 没有 长 度 。mapping 不 可 以 被 分 配给 男 一 个 mapping。 


下 面 给 出 了 一 个 创建 和 使 用 mapping 的 示例 : 


contract sample{ 
mapping (int => string) myMap; 


function sample(int key, string value) { 
myMap[key] = value; 


//myMap2 is a reference to myMap 
mapping (int => string) myMap2 = myMap; 


j 


@ 记 住 : 如 果 想 访问 mapping 中 不 存在 的 key， 返 回 的 value 均 为 0。 


3.46 ”delete 操 作 符 


delete 操 作答 可 以 用 于 任何 变量 ,将 其 设置 成 默认 值 。 默 认 信 均 为 0。 


如 果 对 动态 数组 使 用 delete 操 作 符 ， 则 删除 所 有 元 素 ， 其 长 度 变 为 0。 如 果 对 静态 数组 使 用 delete 操 作 符 ， 则 重 置 所 有 这 
引 。 还 可 以 通过 对 特定 系 引 位 置 使 用 delete 来 重 置 系 引 。 


如 果 对 map 类 型 使 用 delete 操 作答， 什么 都 不 会 友 生 。 但 是 如 果 对 map 类 型 的 一 个 键 使 用 delete 操 作 得 ， 则 会 删除 与 该 键 
相关 的 值 。 


下 面 给 出 了 delete 操 作 符 的 一 个 示例 : 


contract sample { 
Struct DELUGE 4 


mapping (int => int) myMap; 
int myNumber; 


int[] myArray; 
GLTIUCL NYSLIUSE 
function sample(int key, int value, int number, int[] array) { 
//maps cannot be assigned so while constructing struct we ignore 
the maps 


mnysStruct = Struct. (number) ; 


//nere set the map key/value 
myStruct.myMap[key] = value; 


myArray = array; 


function reset () { 


//myArray length is now 0 
delete myArray; 


//myNumber is now 0 and myMap remains as it is 
delete myStruct; 


function deleteKey (int Key) { 


//nere we are deleting the key 
delete myStruct.myMap[key]; 


3.4.7 基本 类 型 之 | 有 的 转换 





除了 数组 类 型 、 字 符 串 类 型 、 结 构 类 型 、 枚 举 类 型 和 map 类 型 外 ， 其 他 类 型 均 称 为 基本 类 型 。 


如 果 把 一 个 操作 符 应 用 于 不 同 的 类 型 ， 编 译 器 将 尝试 把 一 个 操作 数 隐 式 转换 为 男 一 种 类 型 。 通 弟 来 咒 ， 如 果 没 有 语义 信息 到 
失 ， 值 和 类 型 之 间 可 以 进行 隐 式 转换 : uint8 可 转换 为 uint16，int128 可 转换 为 Int256， 但 是 int8 不 可 转换 为 uint256 (因为 
uint256 不 能 存储 ， 例 如 -1) 。 此 外 ， 无 符号 整数 可 以 转换 成 同等 大 小 或 者 更 大 的 字 节 ， 但 是 反之 则 不 然 。 任 何 可 以 转换 成 
uint160 的 类 型 都 可 以 转换 成 地 址 。 


Solidity 也 支持 显 式 转换 。 所 以 ， 如 果 编 译 器 不 允许 在 两 种 数据 类 型 之 间 隐 式 转 换 ， 则 可 以 进行 显 式 转换 。 建 议 尽 量 避 免 显 
陈 转 换 ， 因 为 可 能 返回 难以 预料 的 结果 。 


来 看 一 个 例子 : 


uint32 a 0123490708: 
uint16 b = uint16(a); // b will be 0x5678 now 


这 里 是 将 uint32 类 型 显 式 转换 为 uint16， 也 丈 是 说 ， 把 较 大 类 型 转换 为 较 小 类 型 ， 因 此 高 位 被 砍 挥 了 。 


3.48 (Hvar 

Solidity 提 供 了 用 于 声明 变量 的 var 关 键 字 。 变 量 类 型 根据 分 配给 它 的 第 一 个 值 来 动态 确定 。 一 旦 分 配 了 值 ， 类 型 不 固定 了 ， 
所 以 如 果 给 它 指 定 另 一 个 类 型 ， 将 引起 类 型 转换 。 示 例如 下 : 

int256 x = 12; 


//y type is int256 
var y = x; 


uint256 z= 9; 


//exception because implicit conversion not possible 
y = zj 


hele 


o 记 住 : 在 定义 数组 afray 和 mapb 时 不 能 使 用 vatf。vat 也 不 能 用 于 定义 函数 参数 和 状态 变 


3.5 ”控制 结构 


Solidityszi&if, else, while, for, break, continue, return, ? : 等 控制 结构 。 


下 面 给 出 了 控制 结构 的 一 个 示例 : 


contract sample 
int a = 12; 
intL] Ds 


function sample () 
{ 


//"--" throws exception for complex types 
if(a == 12) 


var temp = 10; 


while(temp < 20) 


{ 
if (temp == 17) 
{ 
break; 
} 
else 
1 
continue; 
} 
tempt+t; 
} 
forivar i111 = QF 111l < D.length; a+) 


{ 


j 


3.6 ”用 new 操 作答 创建 合约 


一 个 合约 可 以 使 用 new 关 键 字 来 创建 一 个 新 合约 ， 但 前 提 是 必须 知道 新 创建 的 合约 的 完整 代码 。 示 例如 下 : 


contract samplel 


1 
int a; 
function assign (int b) 
{ 
a = b; 
} 
} 


contract sample2{ 
function sample2() 


1 
samplel s = new sample1(); 
B.d9Sslgnibaz s 
j 
} 
3.7 异常 


在 一 些 情况 下 ， 异 弟 会 被 目 动 抛 出 。 也 可 以 使 用 throw 手 动 抛 出 异 
销 对 状态 和 余额 的 所 有 改变 ) 。 捕 获 异 常 是 不 可 能 的 : 


。 抛 出 异常 会 停止 回 深 目前 执行 的 调用 (ate, fF 


dik 


contract sample 


{ 
function myFunction () 
{ 
throw; 
} 
} 


3.8 IMBAR 


{ESolidityF, AARAA: ARRARO . ARARE Eae 


ShaBA ets ARANAS ARIK: 


contract samplel 


{ 
int a? 
//"payable" is a built-in modifier 
//This modifier is required if another contract is sending Ether while 


calling the method 
function samplei(int b) payable 


function assign (int €) 


a = C} 


function makePayment (int d) payable 


contract sample2{ 


function hello() 
{ 
} 


function sample2(address addressOfContract) 

{ 
//send 12 wei while creating contract instance 
sample1 s = (new samplel) .value (12) (23); 


s.makePayment (22); 


//sending Ether also 
s.makePayment.value (45) (12); 


//specifying the amount of gas to use 
s.makePayment.gas (895) (12); 


//sending Ether and also specifying gas 
s.makePayment.value (4) .gas (900) (12); 


//nello() is internal call whereas this.hello() is external call 
this.hello(); 


//pointing a contract that's already deployed 
samplel s2 = samplel(addressOfContract); 


s2.makePayment (112); 


0... eue 了 的 调用 称 为 外 部 调用 。 在 函数 中 ，this 关 键 字 代表 当前 合约 实例 。 


39 ”合约 功能 


现在 是 时 候 深 入 学 习 合 约 了 。 我 们 将 看 看 一 些 新 的 功能 ， 还 将 深入 学 习 已 经 见 过 的 一 些 功能 


一 工 


尔 数 或 者 状态 变量 的 可 见 性 定义 了 谁 可 以 看 到 尼 。 阔 数 和 状态 变量 有 四 种 可 见 性 : 


ASS : external, public, internalf[lprivate, 
国 数 可 见 性 默认 为 public， 状 态 变 量 可 见 性 默认 为 internal。 各 可 见 性 函数 的 含义 如 下 : 


-extetnal。 外 部 函数 只 能 由 其 他 合约 调用 ， 或 者 通过 交易 调用 。 外 部 函数 f 不 能 被 内 部 
但 是 this.f () 有 用 。 不 能 把 extetnal 可 见 性 应 用 到 状态 变量 


Eo 


HAAA, AREH, fO 没有 用 ， 


public。 公共 有 函数 和 状态 变量 可 以 用 所 有 可 行 办 法 访问 。 编 译 器 生成 的 存 取 器 
创建 自己 的 存 取 器 。 事 实 上 ， 它 只 生成 getters， 而 不 生成 setters。 


(accessor) 函数 都 是 公共 状态 变量 。 用 户 不 


.intetnal。 内 部 函数 和 状态 变量 只 可 以 内 部 访问 ， 也 就 是 说 ， 从 当前 合约 内 和 继承 它 的 合约 访问 。 不 可 以 使 用 this 访 问 它 。 


:btivate。 私 有 函数 和 状态 变量 类 似 于 内 部 函数 ， 但 是 继承 合约 不 可 以 访问 它们 。 
下 面 给 出 了 可 见 性 和 和 存 取 器 (accessor) 的 一 个 示例 : 


contract samplel 

1 
int public b = 78; 
int internal c = 90; 


function samplel () 

{ 
//external access 
thris.at)s 


//compiler error 
a(); 


//internal access 


b = 21; 


//external access 
Che al 


//external access 
thris.bD1); 


//compiler error 
ENIS DBI 


//compiler error 
CALS GTI 


//internal access 
c= 9; 


function a() external 


{ 


contract sample2 


{ 
int internal d = 9 
int private e = 90; 


//sample3 inherits sample2 
contract sample3 is sample2 


{ 


samplel s; 


function sample3() 


{ 


S = new sample1(); 


//external access 
Sd ti)5 


//external access 
var f = S.D; 


//compiler error as accessor cannot used to 
s.b = 18; 


assign a value 


//compiler error 
S.C(); 


//internal access 
d = 8; 


//compiler error 
e = 7; 


3.9.2 PREX EA ER 


33i 3 BUE UT ERE BX RS (function modifier) 的 概念 ， 还 编写 了 一 个 基本 的 函数 修改 器 ， 现 在 来 深入 学 习 修改 器 。 


修改 器 由 子 合约 (child contract) 继承 ， 且 子 合约 可 以 对 其 重 写 。 可 以 通过 用 空格 分 隔 的 列表 指定 修改 器 将 多 个 修改 器 应 
用 到 一 个 消 数 ， 并 将 多 个 修改 器 按 顺 序 估 值 ;还 可 以 同 修改 器 传送 实 参 。 

在 修改 器 中 ， 无 论 下 一 个 修改 器 体 或 者 消 数 体 二 者 哪个 先 到 达 ， 会 被 插入 到 “” ; 出现 的 地 万 。 

让 我 们 来 看 一 个 函数 修改 器 的 复杂 代码 例子 : 

contract sample 

{ 


int a = 90; 


modifier myModifierl(int b) { 


int c = b; 
= 
C= a; 
= 8; 
} 
modifier myModifier2 { 
int C = a; 
-— 
} 
modifier myModifier3 1 
a = 96; 
return; 
a = 99; 


modifier myModifier4 { 
int C = a; 


j 


function myFunction() myModifiert(a) myModifier2 myModifier3 returns 
(int d) 


a = 1; 
return a; 


myFunction () 的 执行 代码 如 下 : 


int c = b; 
int C =a; 
a = 96; 
return; 
int c = a; 
a = 1; 
return a; 
a = 99; 
C = a8; 
a= 8; 


在 上 述 代 码 中 调用 myFunction () 方法 时 ， 将 返回 0。 但 是 乙 后 访问 状态 变量 a 时 ， 将 得 到 8。 
修改 器 或 者 函数 体 中 的 return (返回 ) 立即 离开 整个 消 数 ， 返 回 值 被 分 配 成 它 需 要 成 为 的 任何 变量 。 


就 消 数 来 说 ，return 之 后 的 代码 在 调用 者 的 代码 完成 运行 后 再 执行 。 吾 修改 器 来 说 ， 上 述 修改 器 中 的 “_; ”之 后 的 代码 在 
调用 者 的 代码 完成 运行 后 再 执行 。 在 上 面 的 例子 中 ， 第 5、6 和 7 行 从 未 执行 过 。 在 第 4 行 之 后 ， 执 行 从 第 8 ~ 10 行 开始 。 


修改 器 中 的 return 不 可 以 有 相关 值 ， 它 总 是 返回 全 0。 


一 个 合约 可 以 有 唯一 的 未 命名 函数 ， 称 为 回 退 函 数 (fallback function) 。 该 函数 不 能 有 实 参 ， 不 能 返回 任何 值 。 如 果 其 他 
尔 数 都 不 能 匹配 给 定 的 函数 标识 待 ， 融 在 合约 调用 上 执行 回 退 函数 。 


当 合约 不 用 任何 六 数 调用 残 接 收 以 太 币 〈 即 交易 友 送 以 太 币 给 合约 却 不 调用 任何 方法 ) 时 ， 也 执行 该 函数 。 在 此 情况 下 ， 用 
于 函数 调用 的 gas 通 常 很 少 (准确 地 说 是 2300 gas) ， 所 以 使 回 退 函数 尽 可 能 便宜 很 重要 。 


接收 以 太 币 但 是 却 不 定义 回 退 函 数 的 合约 会 抛 出 异 弟 ， 把 以 太 币 友 送 回 去 。 所 以 如 果 你 想 让 你 的 合约 接收 以 太 币 ， 融 必须 要 
SEPARA. 


TES T IBBRERSEABI— T zn 0: 


contract sample 

1 
function() payable 
{ 


//keep a note of how much Ether has been sent by whom 


3.94 继承 


Solidity 通 过 代码 备份 (包括 多 态 ) 支持 多 重 继承 (multiple inheritance) 。 即 使 一 个 合约 继承 自 其 他 多 个 合约 ， 在 区 块 链 
上 也 只 创建 一 个 合约 ， 来 目 父 合约 (parent contract) 的 代码 总 是 被 复制 到 最 终 合 约 里 。 示 例如 下 : 


contract samplel 


{ 


function a() {} 


function Hi) 4+ 


//sample2 inherits samplel 
contract sample2 is samplel 


{ 
function b() {} 


contract sample3 


{ 


function sample3(int b) 


{ 


//sample4 inherits from sample1 and sample2 

//Note that sample1 is also parent of sample2, yet there is only a single 
instance of samplel 

contract sample4 is samplel, sample2 

{ 


function ati: 
function Gti 


//this executes the "a" method of sample3 contract 
a(); 


//this executes the 'a" method of samplei1 contract 
samplei.a(); 


//calls sample2.b() because it's in last in the parent contracts 
list and therefore it overrides sample1.b() 
b; 


//If a constructor takes an argument, it needs to be provided at the 
constructor of the child contract. 

//In Solidity child constructor doesn't call parent constructor instead 
parent is initialized and copied to child 

contract sample5 is sample3(122) 


{ 


1.super 关 键 字 


Super 天 键 字 用 于 引用 最 终 继承 链 中 的 下 一 个 合约 ， 示 例如 下 : 


contract samplel 
1 
} 


contract sample2 
{ 
} 


contract sample3 is sample2 
1 
} 


contract sample4 is sample2 
1 
} 


contract sample5 is sample4 
{ 

function myFunc() 

{ 

} 


contract sample6 is samplei, sample2, sample3, sampled 
{ 
function myFunc () 
{ 
//sample5.myFunc () 
super.myFunc(); 


其 中 ， 引 用 sample6 合 约 的 最 终 继承 链 是 sample6、sample5、sample4、sample2、sample3 和 sample1。 继 承 链 始 于 衍 


Maz = 


生 最 充分 的 合约 ， 终 于 衍生 最 不 充分 的 合约 。 
2. 抽 象 合约 


仅 包 含 立 数 原型 而 不 包含 函数 实现 的 合约 称 为 抽 缚 合约 (abstract contract) 。 这 些 合约 不 能 被 编译 (即使 包含 实现 函数 
和 非 实 现 函 数 ) 。 如 果 一 个 合约 继承 目 抽 象 合约 且 不 重 写 并 实现 所 有 非 实 现 邹 数 ， 那 么 它 目 己 也 是 抽象 的 。 


抽象 合约 仪 在 创建 编译 器 已 若 的 接口 时 提供 。 这 在 引用 已 部 署 的 合约 和 调用 其 立 数 时 是 很 有 用 的 。 示 例如 下 : 


contract samplel 


{ 


function a() returns (int b); 


j 


contract sample2 


{ 


function myFunc () 


{ 
samplel s = samplel (Oxd5£9d8d94886e70b06e4 74c3£b14fd43e2f23970) ; 


//without abstract contract this wouldn't have compiled 
s.a(); 


3.10 fg 


EKUTE, IBELEBSHE— MS REDBHE TH Ba, EEÍIUBBHATIISSJSEBRI. DUSUERBDERSSFBEERSEN, AS 
在 调用 合约 (calling contract) 中 执行 ， 也 惑 是 咒 ，this 指 同调 用 合约 ， oi 由 于 库 是 
源 代码 中 独立 的 一 部 分 能 访问 调用 合约 的 状态 变量 ， 如 果 这 些 变量 是 显 式 的 (否则 无 法 命名 这 些 变量 ) 。 


库 没有 状态 变量 一 一 它们 不 支持 继承 ,也 不 能 接收 以 太 币 。 库 可 以 包含 结构 类 型 (struct) 和 枚 举 类 型 (enum) 。 


一 旦 在 区 块 链 中 部 署 Solidity 库 ， 任 何 知道 其 地 址 和 源 代码 (只 知道 原型 或 者 知道 完整 实现 ) 的 人 都 可 以 使 用 它 。Solidity 编 
译 器 需要 有 源 代码 ， 这 样 能 确保 所 欲 访问 的 方法 在 库 中 真实 存在 。 示 例如 下 ; 


library math 


{ 
function addInt(int a, int b) returns (int c) 
1 
return a + b; 
} 
} 
contract sample 
{ 
function data() returns (int d) 
{ 
return math.addInt(1, 2); 
} 
} 


不 能 在 合约 源 代码 中 添加 库 地 址 ， 而 是 需要 在 编译 时 向 编译 器 提供 库 地 址 。 
库 有 许多 使 用 示例 。 两 个 主要 的 示例 如 下 : 


` 如 果 有 许多 合约 ， 它 们 有 一 些 共同 代码 ， 则 可 以 把 共同 代码 部 署 成 一 个 库 。 这 将 节省 gas， 因 为 gas 也 依赖 于 合约 的 规模 。 
因此 ， 可 以 把 库 想象 成 使 用 其 合约 的 基础 合约 。 使 用 基础 合约 (而 非 库 ) 切 分 共同 代码 不 会 节省 gas， 因 为 在 Solidity 中 ， 继 承 通 
过 复制 代码 工作 。 由 于 库 被 当 作 基础 合约 ， 库 里 面 带 有 内 部 可 视 性 的 函数 被 复制 给 使 用 它 的 合约 ; 否则 ， 库 里 面 带 有 内 部 可 视 性 
的 函数 不 能 被 使 用 这 个 库 的 合约 调用 ， 因 为 这 需要 外 部 调用 ， 而 带 有 内 部 可 视 性 的 函数 不 能 通过 外 部 调用 被 调用 。 此 外 ， 库 里 的 
structs 和 enums 被 复制 给 使 用 这 个 库 的 合约 。 


- 库 可 用 于 给 数据 类 型 添加 成 员 芭 


© 如 果 一 个 库 里 只 包含 内 部 函数 和 /或 structs/enums， 则 不 需要 部 署 库 ， 因 为 库 里 面 的 所 有 内 容 都 被 复制 给 使 用 它 的 合 


using for 
using A for B 这 条 指令 可 用 于 连接 库 函 数 (从 库 A 到 任意 类 型 B) 。 这 些 函 数 将 被 调用 的 对 象 作为 它们 的 第 一 个 参数 接收 。 
using A for 的 结果 表示 来 自 库 A 的 函数 被 连接 到 所 有 类 型 。 示 例如 下 : 


library math 
{ 
erruct qySUtructi 1 
int a; 


SJSULERHOL mVoLQructa 4 
int A 


//Here we have to make 's' location storage so that we get a reference. 
//Otherwise addInt will end up accessing/modifying a different instance 


of myStructi than the one on which its invoked 


cont 


{ 


myst 


function addInt(myStructí storage s, int b) returns (int c) 
{ 


return s.a + b; 


function subInt(myStruct2 storage s, int b) returns (int c) 
{ 


return s.a + b; 


ract sample 


//"*" attaches the functions to all the structs 


using math for *; 
math.myotructl sil; 
nath.myStruct2 sz; 


function sample() 

{ 
S1 = math.myStructi (9); 
S2 = math.myStruct2 (9); 


s1. .addInt {27} 
//compiler error as the first parameter of addInt is of type 


ructi so addInt is not attached to myStruct2 
Ss2.mdddlntili 


Solidity 人 允许 函数 返回 多 值 (multiple values) ， 示 例如 下 : 


contract sample 


1 


function al} feturns (int s, String c) 


{ 


return (l1, "ss"): 


function bt) 


{ 
int A; 
string memory B; 
IIIA is L and B as "ss" 
(A, B) =a(); 
JIA is 1 
(A,) = a(); 
ib Te Uae? 
Ls B) = a(); 
} 


3.12 ”导入 其 他 Solidity 源 文件 


Solidity 允 许 一 个 源 文件 导入 其 他 源 文件 ， 示 例如 下 : 


//This statement imports all global symbols from "filename" (and symbols 
imported there) into the current global scope. "filename" can be a absolute 
or relative path. It can only be a HTTP URL 

import "filename"; 


//creates a new global symbol symbolName whose members are all the global 
symbols from "filename". 

import * as symbolName from "filename"; 

//creates new global symbols alias and symbol2 which reference Symbol1 and 
symbol2 from "filename", respectively. 


import (symboli as alias, symbol2j from "filename"; 


//this is equivalent to import * as symbolName from "filename";. 
import "filename" as symbolName; 


3.13 ”全 局 可 用 变量 


有 些 特 殊 变 量 和 阔 数 永远 仔 在 于 全 局 中 。 


3.13.1 ”区 块 和 交易 属性 


区 块 和 交易 属性 有 如 下 几 项 : 
- block.blockhash (uint blockNumber) returns (bytes32) 。 给 定 区 块 的 哈 布 值 ， 只 支持 最 近 256 个 区 块 。 
: block.coinbase (address) 。 当 前 区 块 矿工 的 地 址 。 
- block.difficulty (uint) 。 当 前 区 块 的 难度 值 。 


: block. gaslimit (uint) o 当前 区 块 的 gas 上 限 。 它 定义 了 整个 区 块 中 的 所 有 交易 一 起 最 多 可 以 消耗 多 少 gas。 其 目的 是 使 区 块 
的 传播 和 处 理 时 间 保 持 在 较 低 水 平 ， 这 样 才能 有 足够 去 中 心 化 的 网 络 。 矿 工 有 权利 将 当前 区 块 的 gas 上 限 设置 为 上 一 个 区 块 的 gas 
上 限 ~0.0975% (1/1, 024) 以 内 的 数值 ， 所 以 gas 上 限 的 结果 应 当 是 矿工 偏好 的 中 间 值 。 


block.number (uint) 。 当 前 区 块 的 序号 。 

block.timestamp (uint) 。 当 前 区 块 的 时 间 玲 。 

- msg.data (bytes) 。 完 整 的 调用 数据 里 存储 的 函数 及 其 实 参 。 
msg.gas (uint) 。 当 前 剩余 的 gas。 

msg.sender (address) 。 当 前 调用 发 起 人 的 地 址 。 

-msg.sig (bytes4) 。 调 用 数据 的 前 四 个 字 节 (地 数 标识 符 ) 。 
msg.value (uint) 。 这 个 消息 所 附带 的 货币 量 ， 单 位 为 wei。 
- now (uint) 。 当 前 区 块 的 时 间 玲 ， 等 同 于 block.timestamp。 
 tx.gasprice (uint) 。 交 易 的 gas 价 格 。 


- tx.otigin (address) 。 交 易 的 发 起 人 (完整 的 调用 链 ) o 


3.13.2 ”地 址 类 型 相关 


地 址 类 型 相关 变量 如 下 : 
- <address>.balance (uint256) 。 地 址 余额 ， 单 位 为 wei。 


- <address>.send (uint256 amount) returns (bool) 。 发 送 指 定数 量 的 wei 到 地 址 ， 失 败 时 返回 false。 


3.13.3 ”合约 相关 


合约 相关 变量 如 下 : 


“ this。 当前 合约 ， 可 显 式 转换 成 地 址 类 型 。 


- selfdestruct (address recipient) 。 销 毁 当 前 合约 ， 把 其 中 的 资金 发 送 到 指定 地 址 。 


3.14 DAME 


一 个 数字 可 以 用 wei、finney、szabo 或 者 Ether 等 单位 转换 不 同 面值 的 以 太 币 。 以 太 币 如 果 不 标 明 货 币 单位 ， 就 默认 以 wei 
为 单位 ， 例 如 ，2Ether 可 转换 成 2000finney。 


3.15 ”和 存在 、 具 实 性 和 所 有 权 合 约 的 证 明 


本 节 将 编写 一 个 不 用 出 示 实 际 文件 就 可 以 证 明文 件 所 有 权 的 Solidity 合 约 。 它 可 以 证 明 该 文件 在 某 个 特定 时 间 存 在 ， 并 最 终 
检查 文件 真实 性 (integrity) 。 


将 成 对 存储 文件 哈 希 和 所 有 者 名 字 以 实现 所 有 权证 明 (Proof of Owernership, PoO) ， 成 对 存储 文件 哈 希 和 区 块 时 间 截 
以 实现 存在 证 明 (Proof of Existence, PoE) 。 最 后 ， 和 存储 哈 希 目 身 证 明文 件 真 实 性 ， 也 束 是 说 ， 如 果 文 件 补 修改 了 ， 则 它 的 
哈 希 会 随 之 改变 ， 合 约束 不 能 友 现 任何 这 样 的 文件 了 ， 由 此 证 明文 件 被 修改 了 。 


相关 智能 合约 的 代码 如 下 : 


contract Proof 


1 


struct FileDetails 


{ 
uint timestamp; 
string owner; 


mapping (string => FileDetails) files; 


event logFileAddedStatus (bool status, uint timestamp, string owner, 
string fileHash); 


//this is used to store the owner of file at the block timestamp 
function set(string owner, string fileHash) 
{ 
//There is no proper way to check if a key already exists or not 
therefore we are checking for default value i.e., all bits are 0 
if (files[fileHash].timestamp == 0) 
{ 


files[fileHash] = FileDetails(block.timestamp, owner); 


//we are triggering an event so that the frontend of our app 
knows that the file's existence and ownership details have been stored 
logFileAddedStatus (true, block.timestamp, owner, fileHash); 
} 


else 


1 
//this tells to the frontend that file's existence and 
ownership details couldn't be stored because the file's details had already 


been stored earlier 


logFileAddedStatus(false, block.timestamp, owner, fileHash); 


//this is used to get file information 
function get(string fileHash) returns (uint timestamp, string owner) 


1 


return (files[fileHash].timestamp, files[fileHash].owner); 


3.16 ”编译 和 部 堵 合 约 


以 太 坊 提供 了 solc 编 译 器 ， 其 中 提供 一 个 命令 行 界面 编译 .so 文件 ， 请 访问 如 下 网 
WF: http://solidity.readthedocs.io/en/develop/installing-solidity.html#binary-packages 找 到 安装 指南 ， 并 访 
iSjhttps://Solidity.readthedocs.io/en/develop/using-the-compiler.html| 找 到 使 用 指南 。 我 们 不 会 直接 使 用 solc 编 译 器 ; 而 是 
使 用 soldjs 和 Browser Solidity。Soldjs 人 允许 在 node.js 中 以 编程 方式 编译 Solidity， 而 Browser Solidity 是 一 个 适用 于 小 型 合约 的 
IDE (集成 开 友 环境 ) 。 


现在 使 用 以 太 坊 提供 的 浏览 器 编译 前 面 的 合约 。 如 需 深 入 相关 知识 ， 请 访问 https://Ethereum.github.io/browser- 
solidity/。 用 户 还 可 以 下 载 Browser Solidity 源 代码 ， 并 离线 使 用 。 请 访问 https://github.com/Ethereum/browser- 
Solidity/tree/gh-pages 进 行 下 载 。 


使 用 browser Solidity 的 主要 优点 是 ， 它 提供 了 一 个 编辑 器 (editor) ， 并 生成 代码 以 部 署 合 约 。 


在 编辑 器 中 ， 复 制 粘 贴 前 面 的 合约 代码 。 将 看 到 它 编译 并 提供 web3.js 代 码 ， 以 使 用 geth 交 互 操作 谷 进行 部 署 。 


输出 如 下 : 

var proofContract = 

web3.eth.contract([{"constant":false,"inputs": [{"name":"fileHash", "type":"s 
tring"}],"name":"get", "outputs": [{"name": "timestamp", "type":"uint256"},{"na 
me" ;"owner”™, "type": "strang" |]; "payable" :talse, "type" ="function”"}, ("constant 
";false, "inputs": [{"name":"owner", "type": "string" j; {"name":"fileHash", "type 
""strling"rl,"name"i"sst" ,"outbpubs":Ii[Tl,"bDayvyable":r1alse," type: Iunctlon"r,1 
"anonymous":false,"inputs":[í"indexed":false,"name":"status","type":"bool"] 
;i"indexed":false,"name":"timestamp","type":"uint256"j,("indexed":false,"na 
me":"owner","type":"string"j,í("indexed":false,"name":"fileHash","type":"str 


ing")],"name":"logFileAddedStatus","type":"event")]); 
var proof = proofContract.new( 


1 


from: web3.eth.accounts[0], 
datas “S060 00405205 50 «x4 P 
gas: 4700000 
r function (e, contract) i 
console.log(e, contract); 


if (typeof contract.address !-- 'undefined') { 
console.log('Contract mined! address: ' + contract.address + ' 
transactionHash: ' + contract.transactionHash) ; 
} 


j) 


data 代 表 EVM 理 解 的 字 节 码 (bytecode) . MAREA tekopcode, AARRE A. &Topcode&PG1HX 


gas, 
web3.eth.contract 的 第 一 个 实 参 是 ABl 定 义 。 在 创建 交易 时 使 用 ABIl 定 义 ， 因 为 它 包 合 所 有 方法 的 原型 。 
现在 在 开 上 有 者 模式 下 局 用 挖 矿 ， 运 行 geth。 运 行 如 下 命令 : 


geth --dev --mine 
现在 打开 另 一 个 命令 行 窗 口 ， 在 其 中 输入 下 面 的 命令 ， 以 打开 geth 的 交互 Javascript 操 作 台 : 
geth attach 


这 将 使 JS 操 作 台 连接 到 在 另 一 个 窗口 运行 的 geth 实 例 上 。 


在 browser Solidity 的 右 侧 复 制 web3 部 署 文 本 框 的 全 部 内 容 ， 并 将 其 粘贴 到 交互 操作 台 上 。 现 在 按 <Enter> 键 ,将 首先 得 
到 交易 哈 希 值 ， 待 交易 被 挖 出 来 之 后 ， 将 得 到 合约 地 址 。 交 易 哈 希 值 是 该 交易 的 ， 每 个 交易 的 哈 希 都 不 一 样 。 每 个 被 部 署 的 合约 


都 有 一 个 独特 的 合约 地 址 ， 以 便 在 区 块 链 中 标识 合约 。 


合约 地 址 是 确定 的 ， 它 由 生成 器 (creator) 的 地 址 (from address) 和 生成 器 友 大 的 交易 数量 (交易 随机 数 ) 计算 得 到 . 
这 二 者 用 RLP 编 码 ， 然 后 使 用 keccak-256 hashing 算 法 进行 哈 希 计算 。 我 们 在 后 面 还 将 深入 学 习 交 易 随机 数 。 若 要 更 深入 地 学 
习 RLP， 请 访问 https://github.com/Ethereum/wiki/wiki/RLP。 


下 面 存 储 文件 细节 并 检索 。 

用 如 下 代码 广播 交易 以 存储 文件 细节 : 

var contract obj = 
proofContract.at("0x9220c8eco489a4298b06c2183cf04fb7e8fbd6d4"); 
contract obj.set.sendTransaction("Owner Name", 
"e3b0c44298fci1ci149afbf4c8996£592427ae41e4649p934ca495991p7852b5855", { 


from: web3.eth.accounts[0], 
}, function(error, transactionHash) { 


if (!err) 
console.log(transactionHash) ; 


}) 

这 里 用 得 到 的 合约 地 址 代 蔡 合约 地 址 。proofContract.at 方 法 的 第 一 个 实 参 是 合约 地 址 。 这 里 并 没有 提供 gas， 它 是 自动 计 
算 的 。 

下 面 发 现 文 件 细节 。 为 了 发 现 文件 细节 ， 运 行 如 下 代码 : 


contract_objJ.get.call("e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495 
291b4552b9055")4 


会 得 到 这 样 的 输出 : 


[1477591434, "Owner Name" | 


call 万 法 用 于 在 EVM 当 前 状态 上 调用 一 个 合约 的 方法 。 它 不 广播 交易 。 若 要 读 取 数据 ， 则 不 需要 广播 ， 因 为 会 有 目 己 的 区 块 
链 复 制 。 


我 们 将 在 后 面 的 几 章 中 更 多 地 学 习 web3.js。 


3.17 Bae 


在 本 章 中 ， 我 们 学 习 了 Solidity 编 程 语言 以 及 数据 位 置 、 数 据 类 型 和 合约 的 高 级 功能 ， 还 学 习 了 编译 和 部 署 智能 合约 最 快速 、 
最 简便 的 方法 ， 接 下 来 应 该 放心 地 编写 智能 合约 了 。 


在 下 一 章 中 ， 我 们 将 创建 智能 合约 前 端 ， 这 有 利于 部 署 智能 合约 和 运行 交易 。 


第 4 草 ” 开 始 使 用 web3.js 


在 前 一 章 中 ， 我 们 学 习 了 编写 智能 合约 的 方法 以 及 使 用 web3.js 在 geth 交 互 接口 上 部 署 和 广播 交易 。 在 本 章 中 ， 我 们 将 学 习 
web3.js 的 相关 内 容 ， 包 括 如 何 导 入 、 如 何 连接 到 geth 以 及 如 何在 node.js 或 者 客户 端 JavaScript 中 使 用 它 ， 还 将 学 习 如 何 使 用 
web3.j$ 为 前 一 章 中 的 智能 合约 创建 web 客 户 疹 。 


在 本 章 中 ， 我 们 将 讲解 以 下 内 容 : 
在 hode.js 和 客户 端 JavaSctipt 中 导入 web3.js。 
. 将 web3.js 连 接 到 geth。 
- 探索 用 web3.js 可 以 做 的 各 种 事 。 
. 探索 web3.js 最 常用 的 几 个 API。 


` 为 所 有 权 合 约 创 建 node.js 应 用 。 


41 web3.js 概 述 


web3.js 提 供 了 用 于 和 geth 通 信 的 Javascript API。 它 内 部 使 用 JSON-RPC 与 geth 通 信 。web3.js 还 可 以 与 所 有 种 类 的 、 支 持 
JSON-RPC 的 以 太 坊 节点 通信 。 它 把 所 有 JSON-RPC API 当 作 Javascript API， 也 就 是 说 ， 它 不 仅 支持 所 有 与 以 太 坊 相关 的 
API， 还 支持 与 Whisper 和 Swarm 相关 的 APl。 


随 着 不 同 项 目的 创建 ， 我 们 会 越 来 越 了 解 web3.js。 目 前 我 们 先 来 看 一 些 最 常用 的 web3.Js AP1， 然 后 使 用 web3.js 创 建 一 个 
Pra MS sea ZI aur. 


在 写本 书 时 ，web3.js 的 最 新 版 本 是 0.16.0。 本 章 所 述 内 容 也 是 这 个 版 本 。 


web3.js 托 管 在 https://github.comyethereum/web3.js， 完 整 文档 
ft£https://github.com/ethereum/wiki/wiki/JavaScript-API. 


4.1.1 &Aweb3Js 
为 了 在 node.js 中 使 用 web3.js， 可 以 在 项 目 目录 中 运行 Npm install web3， 且 在 源 代码 中 可 以 使 
FA "require ("web3") ; " SA. 


为 了 在 客户 端 JavaScript 使 用 web3.js， 可 以 使 web3.js 文 件 入 队 ， 该 文件 可 以 在 项 目 源 代 码 的 dist 目 录 中 找到 。 现 
在 ，Web3 对 象 对 全 局 可 用 。 


4.1.2 ”连接 至 节点 

web3.js 可 以 与 使 用 HTTP 或 者 IPC 的 节点 通信 。 我 们 将 使 用 HTTP 与 节点 建立 通信 。web3.js 允 许 与 多 个 节点 建立 连接 。 一 个 
web3 实 例 代 表 与 节点 的 一 个 连接 。 访 实例 公开 了 APIl。 

当 在 Mist 中 运行 一 个 App 时 ， 它 自动 使 一 个 连接 到 mist 节 点 的 web3 实 例 可 用 。 实 例 变量 名 是 web3。 


为 了 连接 到 节点 所 使 用 的 基础 代码 如 下 : 


if (typeof web3 !-- 'undefined') { 
web3 = new Web3 (new 
Web3.providers.HttpProvider ("http://localhost:8545") ); 


j 


首先 ， 通 过 检查 web3 是 否 是 undefined， 来 确定 代码 是 否 企 Mist 中 运行 。 如 果 web3 被 定义 了 ， 则 使 用 已 经 可 用 的 实例 ， 
人 否则， 通过 连接 至 目 定义 节 损 创建 一 个 实例 。 如 果 无 论 App 是 否 在 Mist 中 运行 都 连接 到 目 定义 节 氮 ， 则 从 程序 代码 中 删除 f。 这 
ERE EXE MD Ra fE8545im ANI 1T. 


Web3.providersXxj2 se Re TRUM EINER (在 此 称 为 providers) ， 以 建立 连接 和 传输 信息 。 
Web3.providers.HttpProvider 人 允许 建立 HTTP 连 接 ，Web3.providers.lpcProvider 人 允许 建立 IPC 连 接 。 


web3.currentProvider 属 性 被 自动 分 配给 当前 的 provider 实 例 。 在 创建 web3 实 例 之 后 ， 可 使 用 web3.setProvider () 方法 
改变 provider。 它 有 一 个 实 参 ， 即 新 provider 的 实例 。 


0 记 住 : geth 默 认 禁 用 HTTP-RPC。 所 以 在 运行 gfeth 时 通过 --rpc 选 项 以 使 用 HTTP-RPC。HTTP-RPC 默 认 在 8545 端 口 运 


\ 


一 SN 


web3 显 示 isConnected () 方法 ， 可 用 于 查询 是 否 已 经 与 节点 连接 。 根 据 连接 状态 的 不 同 ， 返 回 true 或 者 false。 


4.1.3 API 结构 


web3 包 合 一 个 eth 对 象 (web3.eth) ， 和 专门 用 于 以 太 坊 区 块 链 交互 ; 还 包含 一 个 shh 对 象 (web3.shh) ， 用 于 whisper 交 
互 。web3.js 的 大 部 分 API 都 在 这 两 个 对 绷 中 。 


所 有 API 都 是 默认 同步 的 。 如 果 想 发 出 异步 请 求 ， 可 以 把 一 个 可 选 回 调 函 数 作为 最 后 的 参数 传送 给 大 多 数 函 数 。 所 有 回调 孙 
数 都 采用 错误 优先 (error-first) 回调 方式 。 


一 些 API 对 于 异步 请 求 采 用 别名 。 例 如 web3.eth.coinbase () 是 同步 的 ，web3.eth.getCoinbase () 是 异步 的 。 示 例如 
F: 


//synce request 
Cy 
{ 
console.log(web3.eth.getBlock(48)); 


} 


catch (e) 


{ 


console.log(e); 


j 


//async request 
web3.eth.getBlock(48, function(error, result) { 
if(lerror) 
console.log (result) 
else 
console.error(error); 


; ) 


getBlock 使 用 区 块 序号 或 者 哈 希 值 获取 区 块 信息 。 或 者 ， 它 可 以 使 用 一 个 字符 串 ， 例 如 "earliest”( 创 世 区 块 ) 、 
"latest”( 区 块 链 最 上 面 的 区 块 ) 或 者 "pending” (正在 挖 的 区 块 ) 。 如 果 不 传送 实 参 ， 则 默认 是 web3.eth.defaultBlock， 默 认 


分 配 "|atest "。 


所 有 需要 区 块 身 份 证 明 作 为 输入 的 API 可 以 用 序号 、 哈 希 值 或 者 一 个 可 读 字符 串 作 为 输入 。 如 果 值 未 通过 ， 则 这 些 API 默 认 
使 用 web3.eth.defaultBlock。 


4.1.4 BigNumber.js 


JavaScript 本 质 上 对 于 正确 处 理 大 数字 不 在 行 。 因 此 ， 需 要 处 理 大 数字 和 进行 完美 计算 的 应 用 会 使 用 BigNumberjs 库 。 


web3.js 还 依赖 于 BigNumber.js， 且 自动 进行 加 载 。web3.js 总 是 对 序号 值 返回 BigNumber 对 象 。 它 可 以 用 JavaScript 数 
、 数 字 字符 串 和 BigNumber 实 例 作为 输入 ， 示 例如 下 : 


MW 


web3.eth.getBalance ("0x27E829fB34d14f3384646F938165dfcD30cFfB7c").toString( 
); 


这 里 使 用 web3.eth.getBalance () 757X3XBOIEZRRR, iZ73;AXiRIBI— T BigNumberXjzs, sss2tEBigNumbenx zs Fal 
toString () ， 把 它 转换 成 数字 字符 串 。 


BigNumberjs 不 能 正确 处 理 有 超过 20 个 浮 点 数位 的 大 数字 ， 因 此 推荐 以 wei 为 单位 仓储 余额 ， 在 显示 时 再 转换 成 其 他 单 
位 。web3.js 目 身 总 是 以 wei 为 单位 返回 和 调 取 余额 。 例 如 ，getBalance () 方法 以 wei 为 单位 返回 该 地 址 的 余额 。 


4.1.5 单位 转换 


web3jjs 提 供 了 把 wei 余 额 转换 成 任何 其 他 单位 和 把 任何 其 他 单位 余额 转换 成 wei 的 APl。 


web3.fromWei () 方法 用 于 将 wei 转 换 成 其 他 单位 ， 而 web3.toWei () 方法 用 于 将 以 其 他 单位 表示 的 数字 转化 成 以 we 为 
单位 的 数字 。 示 例如 下 : 


web3.fromWei("1000000000000000000", "ether"); 
web3.toWei("0.000000000000000001", "ether"); 


第 一 行 代码 将 wei 转 换 为 ether; 第 二 行 代码 将 ether 转 损 为 wei。 广 法 中 的 第 二 个 实 参 可 以 是 以 下 字符 串 乙 一 : 
- kwei/ada 

: mwei/babbage 

: owei/shannon 

- szabo 

- finney 

ether 

- kether/grand/einstein 

: mether 

* gether 


: tether 


4.1.6 targas ME. RDT 


让 我 们 看 看 API 如 何 检索 gas 价 格 、 地 址 余额 和 交易 信息 : 


//It's sync. For async use getGasPrice 
console.log(web3.eth.gasPrice.toString()); 


console.log(web3.eth.getBalance ("0x407d7/73d8a4 9eeb85d32cf£465507dd71d507100c1 
H 4do)to5tringil)j 


console.log(web3.eth.getTransactionReceipt ("0x9fc76417374aa880d4449a1f7f31e 
c597f£00b1f6f3dd2d66f4c9c6c4458364d8b")); 


输出 如 下 : 


20000000000 
30000000000 
{ 


"transactionHash": 
"0x9fc76417374aa880d4449a1f7f31ec597f00b1f6f3dd2d66f4c9c6c445836d8b ", 

"transactionIndex": 0, 

"blockHash": 
"Oxef95f2fled3ca60b048b4bf67cde2195961e0bbao6f70bcbea9a2c4e133e34bp46", 

"blockNumber": 3, 

"ContractAddress": "0xa94f5374fce5bedbc8e2a8697c15331677e6ebf0b", 

"CumulativeGasUsed": 314159, 

"gasUsed": 30234 


上 还 万 法 的 执行 过 程 如 下 : 
- web3.eth.gasPrice () 。 由 x 个 最 新 区 块 的 gas 价 格 中 位 数 决 定 gas 价 格 。 


- web3.ethgetBalance () 。 返 回 任何 给 定 地 址 的 余额 。 所 有 web3.js API 哈 布地 址 应 当 是 十 六 进 制 的 字符 串 ， 而 不 是 十 六 进 制 
的 文字 。solidity 地 址 类 型 的 输入 也 应 当 是 十 六 进 制 的 字符 串 。 


- web3.eth.getTransactionReceipt () 。 用 于 获取 交易 使 用 其 哈 布 的 细节 。 如 果 在 区 块 链 中 发 现 交 易 ， 则 返回 交易 收据 对 象 ; 
和 否则， 返回 null。 交 易 收 据 对 象 包含 下 列 属性 : 


.blockHash。 该 交易 所 在 区 块 的 哈 希 地 址 。 

: blockNumber。 该 交易 所 在 区 块 的 序号 

- transactionHash。 交 易 哈 项 。 

- transactionIndex。 区 块 中 交易 索引 位 置 的 整数 部 分 

‘from. RAZA BEE. 

- to。 接收 者 地 址 ; 如 果 是 合约 创建 交易 ， 则 为 null。 

cumulativeGasUsed。 在 区 块 中 执行 该 交易 时 使 用 的 gas 总 量 。 

gasUsed。 这 个 特定 交易 独自 使 用 的 gas 量 。 

contractAddress。 如 果 交 易 是 合约 创建 ， 表 示 被 创建 的 合约 地 址 ; 否则 ， 为 null。 


. logs。 该 交易 生成 的 日 志 对 象 数 组 。 


41.7 POZVAN 


Laan ea RAWAM. ASLRKUAM, =2(#AHweb3.eth.sendTransaction () 方法 。 访 方法 可 用 于 
上 友 大 任意 种 类 的 交易 ， 但 主要 用 于 友 送 以 太 币 ， 原 因 是 使 用 这 种 方法 部 署 合 约 或 者 调用 合约 方法 比较 麻烦 一 一 它 要 求生 成 交易 
数据 而 不 是 自动 生成 交易 数据 。 该 方法 的 交易 对 象 包含 下 列 属性 : 


易 情 况 下 ， 作 为 合约 的 资金 注入 ， 单 位 也 是 wei) o 


ftom。 发 送 账 户 的 地 址 。 如 未 标明 ， 使 用 web3.eth.defaultAccount 属 性 
约 创 建交 易 ， 该 项 未 定义 

则 自动 决定 该 项 

约 创建 交易 情况 下 ) 。 
17H 的 

则 geth 在 广 


ATS 
约 创 建交 
如 果 不 提 供 
改 字 表示 交易 发 起 人 发 送 的 交易 数量 。 如 果 未 提供 


可 选项 。 信 息 目 的 地 的 地 址 
通常 在 转账 中 单位 为 wei (ES 
使 用 的 gas 量 (未 使 用 的 gas 被 退回 ) 
字符 串 ， 或 者 是 初始 代码 (在 合 
而 nonce 被 设 为 10 


可 选项 。 
可 选项 。 交 易 中 以 wei 为 单位 的 gas 价 格 ， 默 认为 网 络 平均 gas 价 格 。 
。 该 


可 选项 。 


value o 


: gasPrice 
是 包 
它 是 个 整数 。 每 一 个 交易 都 有 一 个 相关 计数 nonce 
~x W 


data。 可 选项 。 相关 数据 的 

nonce. 可 选项 。 | 
则 自动 确定 。 它 的 作用 是 防止 重播 攻击 。nonce 不 是 与 挖 区 块 相关 的 那个 随机 数 。 如 果 使 用 的 nonce 大 于 交易 应 当 
则 交易 被 放 入 一 个 队列 直到 其 他 交易 数量 到 达 。 例 如 ， 如 果 下 一 个 交易 的 nonce 应 该 是 4 
nonce 为 10 的 交易 称 为 排队 交易 ， 而 不 是 待定 交易 。 
web3.eth.sendTransactionl(t 

Á 
geth 时 ， 确 保 使 用 unlock 选 项 解锁 两 个 账户 。 在 geth 交 互 接口 上 ， 提 示 输 入 


var txnHash - 
Eron: . 
web3.eth.accounts[1], 
web3.toWei("1" 
选 
这 个 万 法 返回 交易 


LO: 
value 
一 个 以 太 币 。 在 运行 
， 交 互 接口 以 外 的 web3.js API 将 返 
web3.personal.unlockAccount (addr 
交易 


nonce, 
nonce, Jh|z Z4 
播 这 个 交易 之 前 将 等 待 之 间 的 6 个 交易 。 
回 一 个 地 址 友 送 以 太 币 的 示例 如 下 
web3.eth.accounts [0] 
"ether") 
[B]error, 台 希 。 然 后 可 以 使 用 
, pwd) 和 


— f— 


以 调 


P; 


里 从 账 尸 0 同 账 尸 1 友 
疲 锁定 
getTransactionReceipt () 万 法 检查 是 否 挖 出 了 
BAIR. I 


x 
密码 ， 但 是 如 果 账 户 被 锁 
可 以 用 web3.personal.listAccounts () 
web3.personal.newAccount (pwd) 实时 管理 账户 
开 合 约 、 如 何 使 用 一 个 已 部 署 合 约 的 地 址 获取 其 引用 、 如 何 向 合约 友 这 以 太 币 、 如 何 友 


约 的 引用 ， 首 先 需 要 使 用 web3.eth.contract () 方法 创建 一 个 


4.1.8 “处理 合约 
d: m£ 
以 及 如 何 估算 一 个 函数 调用 的 gas 


让 我 们 学 习 如 何 部 署 一 
用 合约 的 阔 数 (万 法 ) ， 上 

要 部 署 一 个 新 合约 或 者 获取 一 个 已 部 署 合 
法 以 合约 ABI 作 为 一 个 实 参 ， 并 返回 合约 对 象 。 


创建 合约 对 象 的 代码 如 下 


var proofContract = 
web3.eth.contract([{"constant":false, "inputs": [{"name":"fileHash", "type": "s 
tring"r],"name";"get","outpüts":;[i"'mame":"tinestamp","type":"unintZ56"],4|1"na 
mne":"owner","tpe"i"*string"l]l,"pavable"sfalse,"rype"."runcE20D";,1i1"constant 
":false,"inputs":z[l["name"s"owner","type":"string",1i("name":"£fileHash"," "type 
":"Usetrrng"ls."name"i"set","outputs"s[],"pavable":false,"tvpe":"function":,4 
"anonymous"*false,"inoutLs":[i1"xndexed"sfalsse,"name"2i"sratus'", 'type":"bool") 
,i"indexed":false,"name":"timestamp","type":"uint256"j,[("indexed":false,"na 
me":"owner","type":"string"j,í("indexed":false,"name":"fileHash","type":"str 
ing"}], "name":"logFileAddedStatus", "type":"event"}]); 


有 了 合约 之 后 ， 可 以 使 用 合约 对 象 的 新 方法 部 署 它 ， 或 者 使 用 at 方法 获取 与 ABI 匹 配 的 、 一 个 已 部 署 合约 的 引用 。 


部 署 合约 的 示例 如 下 : 


var proof = proofContract.new ({ 
from: web3.eth.accounts[0], 
data: "0x6060604052010698..." 
gas: "4700000" 


Ps 
function (e; contract) { 
if(e) 
{ 
cGonsole.lLoqi"Error T $.e6)$; 
} 
else if (contract .address != undefined) 
{ 
console.log("Contract Address: " + contract.address); 
} 
else 
{ 
console.loqit"Ixn Hash: ™ + contract.transactionHash) 
} 
Ej 


其 中 ，new 万 法 的 调用 是 异步 的 ， 所 以 如 果 成 功 创建 和 广播 交易 ， 回 调子 数 将 被 调用 两 次 。 第 一 次 ， 广 播 交 易 之 后 调用 它 ; 


第 二 次 ， 挖 出 交易 之 后 调用 它 。 如 果 不 提供 回调 函数 ， 则 proof 变 量 的 address 属 性 被 设 成 undefined。 挖 出 交易 之 后 ，address 


BERIE. 


feproof G44, SAER, GEUREA, MÉE RAAM Enew Di AAIR. ENRE Stfromits 
址 、 合 约 字 节 码 和 使 用 的 gas 上 限 。 这 三 个 属性 必须 存在 ， 否 则 无 法 创建 交易 。 该 对象 可 以 有 被 传送 给 SendTransaction 方 法 的 
对 象 所 展示 的 属性 ， 但 是 这 里 ，data 是 合约 字 节 码 ， 且 to 属性 被 忽略 。 


可 以 用 at 方 法 引用 一 个 已 经 部 署 的 合约 。 相 关 代码 如 下 


var proof = proofContract.at("0xd45e541ca2622386cd820d1d3be74a86531c14a1"); 


MEERE ARSALAN A. ASU: 


proof.set.sendTransaction("Owner Name", 
"e3b0c44298fcicil49afbf4c8996fb92427ae41e46495934ca4959915p785250855", | 


from: web3.eth.accounts[0], 
), function(error, transactionHash) { 


if (lerr) 


console.log(transactionHash); 


;) 


这 里 调用 方法 同名 对 象 的 SendTransaction 方 法 。 被 传送 给 这 个 sendTransaction 方 法 的 对 象 属性 与 
web3.eth.sendTransaction () 相同 ， 只 是 data 和 to 属性 被 忽略 了 。 


如 果 想 调用 记 点 本 地 的 方法 ， 而 非 创 建交 易 并 广播 ， 则 可 使 用 call 而 非 sendTransaction。 示 例如 下 : 


var returnValue = 


proof.get.call("e3b0c44298fcic149afbf4c8996f592427ae41e46495934ca495991p785 
21558355") 


有 时 必须 发 现 找到 调用 方法 所 需 的 gas， 这 样 可 以 决定 是 否 调用 。web3.eth.estimateGas 可 用 于 此 目的 。 然 而 ， 直 接 使 用 
web3.eth.estimateGas () 要 求生 成 交易 ， 因 此 可 以 使 用 方法 同名 对 象 的 estimateGas () 方法 。 示 例如 下 : 


var estimatedGas - 


proof.get.estimateGas ("e3b0c44298fc1c149afbf4c8996fb92427ae41e4649p5p934ca495 
> eds A ei: 小， 


0 如 果 只 想 发 送 一 些 以 太 币 到 合约 ， 而 不 调用 任何 方法 ， 则 可 以 使 用 web3.eth.sendTtansaction 方 法 。 


41.9 ”检索 和 监听 合约 事件 
现在 让 我 们 看 看 如 何 监听 一 个 合约 事件 。 监 听 事 件 很 重要 ， 因 为 通过 交易 调用 方法 的 结果 通常 是 以 触发 事件 的 形式 返回 的 。 


0 在 了 解 如 何 检索 和 监听 事件 之 前 ， 我 们 需要 学 习 事 件 的 索引 参数 。 一 个 事件 最 多 有 三 个 参数 可 以 有 被 索引 (indexed) 
属性 。 该 属性 用 于 提示 节点 对 它 进行 索 引 ， 这 样 应 用 客户 端 可 以 用 匹配 返回 值 来 检索 事件 。 如 果 不 使 用 indexed 属 性 ， 则 必须 检 
索 所 有 事件 ， 并 筛选 出 需要 的 那些 事件 。 例 如 ， 可 以 这 样 编写 logFileAddeqdStatus 事 件 : 


event logFileAddedStatus (bool indexed status, uint indexed timestamp, 
string owner, string indexed fileHash); 


下 面 是 给 出 了 监听 合约 事件 的 一 个 示例 : 


var event = proof.logFileAddedStatus (null, { 
tromBlocks Uj 

toBlock: "latest" 

r); 


event .get (function(error, result) { 


IL (Lerr or) 
{ 
console.log(result) ; 
} 
else 
1 
console.log(error); 
} 
;) 
event.watch(function(error, result) { 
if ('error) 
{ 
console.log(result.args.status); 
} 
else 
{ 
console.log(error); 
} 
;) 
setTimeout(function()(í 
event.stopWatching(); 
}, 60000) 
var events = proof.allEvents ({ 
Proms Lock =: O; 
tobBlock: "latest" 
i): 
events.get(function(error, result) { 
if ('error) 
{ 
console.log (result); 
} 
else 
{ 
console.log (error); 
} 
F) 
events.watch(function(error, result){ 
1¢ (terror) 
{ 
console.log(result.args.status); 
} 
else 
{ 
console.log(error); 
} 
}) 
set Timeout (function () { 
events.stopWatching(); 
}, 60000) 


上 述 代码 的 执行 过 程 如 下 : 


1) 调用 一 个 合约 实例 的 事件 同名 的 方法 获取 事件 对 象 。 访 万 法 用 两 个 对 象 作为 实 参 ， 用 于 


^ 


(rb 


选 


事件 : 


S — ANS RAK RA ih SERES ldo, f{'valueA': 1, 'valueB': [myFirstAddress, mySecondAddress]}. PFA fp BAA 


都 默认 设置 为 nall。 这 意味 着 它们 将 匹配 该 合约 发 出 的 任意 类 型 事件 。 


` 第 二 个 对 象 可 以 包含 三 个 属性 ， 即 fromBlock (搜索 起 始 区 块 ， 默 认为 "latest") 、toBlock (搜索 截至 区 块 ， 黑 认为 "latest'") 
和 addtess ( 仅 获 取 日 志 的 地 址 列表 ; 默认 为 合约 地 址 ) 。 


2) 事件 对 象 显示 三 种 方法 : get、watch 和 stopWatching。get 用 于 获取 区 块 沁 围 内 的 所 有 事件 。watch 与 get 类 似 ， 但 是 
它 在 获取 事件 后 还 监听 变化 。stopWatching 可 以 用 于 停止 监听 变化 。 


3) 合约 实例 的 allEvents 万 法 用 于 检索 合约 的 所 有 事件 。 
4) 每 一 个 事件 由 一 个 包含 下 列 属性 的 对 象 代表 。 


argg。 一 个 带 有 来 自 事件 的 实 参 的 对 象 。 
”evVefphto 用 一 个 字符 串 表 示 事 件 名 。 

. logIndex。 用 一 个 整数 表示 区 块 中 的 上 日志 索引 位 置 。 

.ttansactionIndex。 用 一 个 整数 表示 日 志 最 初 的 交易 索引 位 置 。 
.ttansactionFHash。 用 一 个 字符 串 表 示 日 志 最 初 的 交易 哈 布 。 

address。 用 一 个 字符 串 表 示 日 志 最 初 的 地 址 。 

“ blockHash。 用 一 个 字符 事 表 示 日 志 所 在 区 块 的 哈 希 。 如 待定 ， 则 为 pull。 
: blockNumber。 日 志 所 在 区 块 的 序号 。 如 待定 ， 则 为 null。 


0 web3.js 提 供 web3.eth.filter API 以 检索 和 监听 事件 。 用 户 可 以 使 用 这 个 API， 但 是 处 理事 件 的 Event 方 法 更 简便 。 要 想 学 


习 更 多 内 容 ， 请 访问 https://github.com/ethereum/wiki/wiki/JavaScript-API#web3ethfilter。 


4.2 ARANAAUZE um 


在 前 一 章 中 ， 我 们 为 所 有 权 合约 编写 了 solidity 代 码 ; 在 前 一 章 和 本 章 中， 我们 学 习 了 web3jjs 的 有 关 知 识 和 使 用 web3.js 调 
用 合约 的 万 法 。 现 在 是 时 候 为 智能 合约 创建 客户 帆 了 ， 这 样 方便 用 户 使 用 。 


创建 一 个 客户 端 ， 用 户 从 中 选择 一 个 文件 ， 输 入 所 有 者 细节 ， 然 后 按 下 Submit 按 钮 广播 交易 ， 用 文件 哈 希 和 所 有 者 的 细节 
调用 合约 的 set 方 法 。 一 旦 交易 被 成 功 广 播 ， 将 显示 交易 哈 希 。 用 户 还 能 够 选择 一 个 文件 ， 并 从 智能 合约 中 得 到 所 有 者 的 细节 。 
客户 端 还 将 实时 显示 最 新 挖 出 的 set 交 易 ，。 

我 们 将 在 前 端 使 用 sha1.js 获 取 文件 哈 希 ， 使 用 jQuery 进行 DOM 操 纵 ， 并 使 用 Bootstrap 4 创建 一 个 反应 层 (responsive 
layout) 。 在 后 端 使 用 express.js 和 web3.js。 我 们 将 使 用 socket.io， 这 样 不 需要 前 端 间隔 相等 的 时 间 请 求 数据 ， 后 端 就 把 最 近 


FSH ASS HES Buia. 


On 但 对 于 应 用 是 个 安全 漏洞 。 也 就 是 说 ， 我 们 在 使 用 存储 在 geth 中 的 账户 ， 并 把 geth 节 点 URL 
显示 给 前 端 ， 这 将 使 存储 在 那些 账户 中 的 以 太 币 面临 风险 。 


4.2.1 ”项目 结构 


在 本 章 的 练习 文件 中 ， 将 发 现 两 个 目录 : Final 和 Initial。Final 包 含 项 目的 最 终 源 代码 ， 而 Initial 包 含 可 以 用 于 迅速 创建 应 用 
的 空 的 源 代码 文件 和 库 。 


O 为 了 测试 Final 目 录 ， 需 要 在 其 中 运行 hpm install， 并 把 app.js 中 硬 编 码 的 合约 地 址 替换 为 在 部 署 合约 之 后 得 到 的 合约 地 
址 。 然 后 ， 使 用 Final 目 录 中 的 node app.js 命 令 运 行 该 应 用 。 


在 Initial 目 录 中 ， 将 友 现 一 个 public 目 录 和 两 个 文件 (app.js 和 package.json) 。package.json 包 含 应 用 的 后 尊 相 关内 
容 ，app.js 包 含 应 用 的 后 端 源 代码 。 


public 目 录 包 含 与 前 问 相 关 的 文件 。 在 public/css 中 会 发 现 bootstrap.min.css， 它 是 Bootstrap 库 ; 在 public/html 中 会 发 现 
index.html， 所 应 用 的 HTML 人 代码 放 在 这 里 ; 在 public/js 目 录 中 将 友 现 jQuery、sha1 和 socket.io 的 JS 文 件 。 在 public/js 中 还 会 
上 友 现 一 个 main,js 文 件 ， 应 用 的 前 闯 JS 代 码 放 在 这 里 。 


4.2.2 ”创建 后 端 


先 创建 App 后 端 。 首 先 ， 在 initial 目 录 中 运行 hpm install， 为 后 端 安 装 所 需 相 关内 容 。 其 次 ， 在 进行 后 端 编码 之 前 ， 确 保 
geth 运 行 时 启用 rpc。 如 果 是 在 私有 网 络 上 运行 geth ， 要 确保 局 用 mining。 最 后 ， 确 保 账户 0 存在 并 被 解锁 。 可 以 在 私有 了 网 络 上 
运行 geth ， 这 时 需要 局 用 rpc 和 mining， 并 解锁 账户 0: 


geth --dev --mine --rpc --unlock-0 


编码 开始 前 最 后 需要 做 的 一 件 事 是 ， 使 用 在 前 一 章 中 见 到 的 代码 部 署 所 有 权 合 约 ， 并 复制 合约 地 址 。 
现在 创建 一 个 单独 的 服务 端 ， 它 将 为 浏览 器 提供 HTML， 并 接收 socket.io 连 接 : 


var express = require("express"); 

var app = express(); 

var server - require("http").createServer (app); 
var io = require("socket.io") (server); 
server.listen(8080); 


这 里 把 运行 在 端口 8080 上 的 两 个 服务 端 express 和 socket.io 合 并 成 一 个 服务 端 。 


现在 创建 路 径 以 用 于 静态 文件 和 App 主 页 。 相 天 代码 如 下 : 


app.use(express.static("public")); 

app.get("/", function(req, res) { 
res.sendFile(__dirname + "/public/html/index.html"); 

}) 


这 里 使 用 了 express.static 中 辐 件 ， 用 于 企 公共 目录 中 上 友 现 静态 文件 。 
现在 连接 到 geth 节 点 ， 并 获取 已 部 署 合约 的 引用 ， 这 样 可 以 友 送 交易 并 监听 事件 。 相 关 代 码 如 下 : 
var Web3 = require("web3"); 
web3 = new Web3(new Web3.providers.HttpProvider ("http://localhost:8545")); 


var proofContract - 


web3.eth.contract([{"constant":false,"inputs":[{"name":"fileHash", "type":"s 
trang” |], name: get"; “outputs”: [4 "name". tt Imes tanp r “Cype”" <"UuInt 2550" +, 1" a 
me":"owner", "type":"string"}],"payable":false, "type":"function"}, {"constant 
"sfalse, "inputs": [{"name":"owner", "type": "string"},{"name":"fileHash", "type 
"A TSEETIIEQqUE],"name^:;tgerp".ToubPDuES" Il payable fa LSe; "rtyboe""funcbion".,1 
"anonymous":false, "inputs": [{"indexed":false,"name":"status", "type":"bool"} 
,{ "indexed": false, "name":"timestamp", "type":"uint256"}, {"indexed":false,"na 
me":"owner","type":"spring"l,4"indexed":;false,"name":"fileHash","trtype":"str 


ing"}],"name":"logFileAddedStatus", "type":"event"}]); 


var proof = proofContract.at("Oxf7f02f65d5cd8744d180c3575cb8813a9e7736066"); 
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现在 创建 广播 交易 和 获取 文件 信息 的 路 径 。 相 关 代码 如 下 : 


app.get("/submit", function (req, res) { 
var fileHash = req.query.hash; 
var owner - req.query.owner;j 
proof.set.sendTransaction(owner, fileHash, { 
from: web3.eth.accounts[0], 
), function(error, transactionHash) { 
if (lerror) 
{ 
res.send(transactionHash) ; 
} 
else 
{ 
res.send("Error"); 
} 
;) 
F3 
app.get ("/getInfo", function(req, res) { 
var fileHash = req.query.hash; 
var details = proof.get.call(fileHash) ; 
res.send (details); 


;) 


其 中 ，“/submit” 路 径 用 于 创建 和 广播 交易 。 获 取 交 易 哈 硕 之 后 ， 把 它 友 送 给 客户 病 。 然 后 等 待 挖 出 交易 。 
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/getinfo” 路 径 用 于 调用 节点 目 身 的 合约 get 方 法 ， 而 非 创 建交 易 。 它 仅仅 友 送 回 所 得 到 的 回应 。 


现在 监听 来 自 于 合约 的 事件 ， 并 向 所 有 客户 端 广播 。 相 天 代码 如 下 : 


proof.logFileAddedStatus().watch(function(error, result) { 
if(lerror) 


1 
if(result.args.status -- true) 
1 
io.send(result); 
} 
} 
;) 


这 里 需要 检查 一 下 状态 是 否 为 true， 如 果 为 true， 才 能 向 所 有 连接 的 socket.io 客 户 端 广播 事件 。 


4.2.3 ”创建 前 端 


让 我 们 从 应 用 的 HTML 开 始 创建 前 端 。 把 下 面 的 代码 放 入 index.html 文 件 : 


«IDOCTYPE Ttml> 
«html lang="en"> 
<head> 


<meta name="viewport" content="width=device-width, initial-scale-1, 
shrink-to-fit=no"> 


<link rel="stylesheet" href="/css/bootstrap.min.css"> 
</head> 
<body> 
<div class="container"> 
<div class="row"> 
«div class-"col-md-6 offset-md-3 text-xs-center"» 
cbr 
<h3>Upload any file</h3> 
<br> 
<div> 
«div class-"form-group"» 
«label class-"custom-file text-xs-left"» 
«input type-"file" id="file" class-"custom- 
file-input"» 
«span class-"custom-file-control"»«/span» 


«/label» 
«rdres 
<div class-"form-dqroup"» 
«label for="owner">Enter owner name</label> 
<input type="text" class-"form-control" 
id-"owner"» 


</div> 

«button onclick="Submit()" class="btn btn- 
primary">Submit</button> 

«button onclick="getInfo()" class="btn btn- 
primary">Get Info</button> 

<br><br> 


<div class="alert alert-info" role="alert" 
id="message"> 
You can either submit file's details or get 
information about it. 
«div» 
erdgxv 
SH ae is 
</div> 
«div class="row"> 
<div class-"col-md-6 offset-md-3 text=<xs-center"> 


<Dr> 
<h3>Live Transactions Mined</h3> 
xd onn. 
«ol id="events_list">No Transaction Found</ol> 
«/div» 
«/div» 
«/div» 


«script type="text/javascript" src="/js/shal.min.js"></script> 
<script type="text/javascript" src="/js/jquery.min.js"></script> 
<script type="text/javascript" src="/js/socket.io.min.js"></script> 
<script type="text/javascript" src="/js/main.js"></script> 
</body> 
</html> 


上 述 代 码 的 执行 过 程 如 下 : 
1) 显示 Bootstrap 的 文件 输入 框 ， 这 样 用 户 可 以 选择 一 个 文件 。 


2) 显示 一 个 文本 框 ， 用 户 可 以 输入 所 有 者 的 细节 。 


3) 得 到 两 个 按钮 。 一 个 用 于 存储 文件 哈 希 和 合约 中 的 所 有 者 细节 ， 另 一 个 用 于 从 合约 中 获取 文件 信息 。 单 击 Submit 按 钮 触 
submit () 方法 ， 单 击 Get Info 按 钮 触发 getlnfo () 方法 。 


4) 得 到 一 个 显示 信息 的 报警 框 。 
5) 显示 一 个 有 序列 表 ， 以 显示 用 户 在 该 页 面 上 时 家 挖 出 的 合约 交易 。 
接 下 来 为 getlnfo () 和 submit () 方法 编写 实现 ， 与 服务 端 建 Ysocket.io 连 接 ， 并 从 服务 端 监 听 socket.io 人 信息。 


相关 代码 如 下 。 把 该 代码 放 入 main.js 文 件 : 


function submit () 

{ 
var file = document.getElementById("file").files[0]; 
if (file) 

{ 

var owner = document .getElementById ("owner") .value; 
if (owner == "") 

{ 


alert ("Please enter owner name"); 


} 
else 
{ 
var reader = new FileReader(); 
reader.onload = function (event) { 
var hash = shal (event.target.result) ; 
S.get ("/submit?hash=" + hash + "&owner=" + owner, function(data) { 
1f(data == "Error") 
{ 
S("#message") .text ("An error occured."); 
} 
else 
{ 
S("#message") .html("Transaction hash: " + data); 


} 

Ir); 

上 7 
reader.readAsArrayBuffer(file); 


j 


else 


{ 


alert ("Please select a file"); 


j 


function getInfo() 


var file = document.getElementById("file") 
if(file) 
{ 
var reader = new FileReader(); 
reader.onload = function (event) { 
var hash = shai (event.target.result); 


.files[0]; 


S.get ("/getInfo?hash=" + hash, function(data) { 


if(data[0] == 0 && data[1] == "") 
{ 

S("#message") .html ("File not found"); 
j 


else 


{ 


S("#message") .html ("Timestamp: " + data[0] + " Owner: 


} 
P); 
}; 
reader.readAsArrayBuffer (file); 
} 
else 
{ 


alert ("Please select a file"); 


} 

var socket = io("http://localhost:8080"); 
Socket.on("connect", function () { 
Socket.on("message", function (msg) { 


+ datallljj 


if ($("#events_list") .text() == "No Transaction Found") 
{ 

S("#events_list™) -html ("<li>Txn Hash: " + msg.transactionHash. + 
"nOwner: " + msg.args.owner + "nFile Hash: " + msg.args.fileHash + 
和 
} 
else 


{ 

$ ("#events_list") .prepend("<li>Txn Hash: " 
"nOwner: " + msg.args.owner + "nFile Hash: " 
"oy qma 


上 述 代码 的 执行 过 程 如 下 : 


+ msg.transactionHash + 
+ msg.args.fileHash + 


1) 定义 submit () 方法 。 在 submit 访 法 中 ， 确 保 选 择 一 个 文件 ， 且 文本 框 不 为 空 ， 然 后 读 取 文 件 内 容 作为 数组 缓 仔 ， 并 


传送 数组 缓存 给 sha1.js 显 示 的 sha1 () 万 法， 以 获取 数组 缓 仔 中 的 内 容 哈 希 。 得 


给 “/submit” 路 径 ， 然 后 在 报警 框 中 显示 交易 哈 希 。 


到 哈 希 之 后 ， 使 用 jQuery 发 出 一 个 AJAX 请 求 


2) 定义 getlnfo () 万 法 。 该 万 法 首先 确定 选中 一 个 文件 ， 然 后 殊 像 之 前 一 样 生成 哈 希 ， 并 友 出 请 求 到 “/getinfo” 端 点 ， 


以 得 到 关于 那个 文件 的 信息 。 


3) 使 用 socket.io 库 显示 的 io () 方法 建立 socket.io 连 接 ， 然 后 等 待 事件 连 


立 之 后 ， 监 听 来 目 服 务 端 的 信息 ， 并 向 用 尸 显 示 交 易 细节 。 


妆 到 触 友 器 一 一 这 表示 连 


连接 已 经 建立 。 在 连接 建 


Q PENE 是 因为 存储 文件 很 昂贵 一 一 它 需 要 大 量 gas。 对 于 本 节 的 示例 子 ， 其 实 不 需要 
存储 文件 ， 因 为 网 络 中 的 节点 将 可 以 看 见 文 件 。 因 此 ， 如 果 用 户 希 望 文件 内 容 是 秘密 的 ， 其 实 是 做 不 到 的 。 这 里 的 应 用 是 想 证 明 
一 个 文件 的 所 有 权 ， 而 不 是 像 云 服务 那样 存储 和 服务 文件 。 





4.2.4 测试 客户 痛 


运行 app.js 节 点 ， 以 运行 应 用 服务 端 。 打 开 浏 览 器 ,访问 http://localhost: 8080/， 可 以 看 到 图 4-1 所 示 的 界面 。 


Upload any file 


Choose file... Browse 


Enter owner name 


EET 


You can either submit file's details and get information about it. 





Live Transactions Mined 


No Transaction Found 


图 41 


现在 选择 一 个 文件 ， 输 入 所 有 者 姓名 ， 单 击 Submit 按 钮 ， 界 面 将 变 为 图 4-2 所 示 的 样子 。 


c| | 
^ 
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Upload any file 


Choose file... Browse 


Enter owner name 


Narayan Prusty 


Transaction hash: 
0x829f4ae84a16ba63a16382f3bb4f101aad7e62a93459624ce68c69b04780ddbd8 


Live Transactions Mined 


No Transaction Found 


图 42 
在 这 里 可 以 看 到 显示 交易 哈 希 。 现 在 等 待 ， 直 a 到 交易 被 挖 出 。 一 旦 挖 出 ， 残 可 以 在 当前 交易 列表 中 看 到 交易 ， 如 图 4-3 所 


Upload any file 


Choose file... Browse 


Enter owner name 


Narayan Prusty 


Transaction hash: 
0x829f4ae84a16ba63a16382f3bb4f1012aad7e6a93459624ce68c69b04780ddbd8 


Live Transactions Mined 


m Txn Hash: 
0x829f4ae84a16ba63a16382f3bb4f101aad7e62393459624ce68c69b04780ddbd8 
Owner: Narayan Prusty File Hash: 
0663f8458e5297 1cd7e257db0250ffac362d1af8 


E 43 


现在 再 次 选择 同一 个 文件 ， 单 击 Get Info 按 钮 ， 界 面 如 图 4-4 所 示 。 


Upload any file 


Choose file... Browse 


Enter owner name 


Narayan Prusty 


Timestamp: 1479667414 Owner: Narayan Prusty 


Live Transactions Mined 


; Txn Hash: 
0x829f4ae84a16ba63a16382f3bb4f101aad7e6a93459624ce68c69b04780ddbd8 
Owner: Narayan Prusty File Hash: 
0663f8458e5297 1cd7e257db0250ffac362d 1 af8 


图 44 
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43 总 结 


IONE 


在 本 章 中 ， 我 们 首先 通过 示例 学 习 了 web3.js 的 基础 知识 ， 包 括 如 何 连 接 至 节点 、 基 础 API、 发 送 不 同 种 类 的 交易 以 及 监听 事 
件 ， 最 后 为 所 有 权 合 约 建 立 了 一 个 适合 生产 用 途 的 客户 端 。 现 在 可 以 编写 智能 合约 和 创建 UI 客户 端 了 。 


在 下 一 章 中 ， 我 们 将 创建 钱包 服务 ， 可 供用 户 在 其 中 方便 地 创建 和 管理 以 太 坊 钱包 ， 这 也 是 离线 的 。 我 们 将 专门 使 用 
LightWallet 库 实现 上 述 目的 。 


Bom ”创建 钱包 服务 


钱包 服务 用 于 友 送 和 接收 钱 和 于。 创建 钱包 服务 面临 的 主要 挑战 是 安全 和 信任 。 用 户 必 须 党 得 他 的 钱 是 安全 的 ， 并 相信 钱包 服 
务 管理 员 不 会 偷 他 的 钱 。 本 章 所 涉及 的 钱包 服务 将 处 理 这 些 问 题 。 


本 章 将 讲解 以 下 内 容 : 


在线 钱 包 和 离线 钱包 的 区 别 。 


Sx 


- 用 Hooked-YWeb3-Providerf 和 EtheteumJS-tx 库 使 创建 和 签署 那些 没有 被 以 太 坊 节点 管理 的 账户 交易 变 得 容易 。 
- 理解 HD 钱 包 的 概念 及 其 使 用 方法 。 
: 使 用 Lightyallet.js 创 建 HD 钱 包 和 交易 签名 者 。 


` 创建 钱包 服务 。 


5.1 在线 钱包 和 离线 钱包 的 区 别 


钱包 是 多 个 账户 的 集合 ， 账 尸 是 一 个 地 址 及 其 相关 私 钥 的 集合 。 


如 果 一 个 钱包 与 互联 网 相 联 ， 则 称 其 为 在 线 钱包 。 例 如 ， 在 geth 中 存储 的 钱包 、 任 何 网 站 /数据 库 等 都 称 为 在 线 钱 包 。 在 线 
钱包 也 称 为 热钱 包 、Web 钱 包 、 托 管 钱包 等 。 不 推荐 使 用 在 线 钱包 ， 全 少 企 仓储 大 量 以 太 币 或 者 长 期 仓储 以 太 币 时 不 推荐 使 
用 ， 因 为 有 风险 。 而 且 根 据 钱包 存储 位 置 的 不 同 ， 它 还 可 能 要 求 信任 第 三 方 。 


例如 ， 最 热门 的 钱包 服务 本 身 存 储 钱包 私 钥 ， 并 人 允许 用 户 通过 e-mail 和 密码 访问 钱包 ， 所 以 用 户 基 本 上 不 会 实质 性 地 访问 钱 
包 ， 如 果 有 人 想 偷 ， 束 能 偷 钱包 里 的 钱 。 


如 果 一 个 钱包 不 与 互联 网 相 联 ， 则 称 其 为 离线 钱包 。 例 如 ， 存 储 在 内 存盘 、 纸 张 、 文 本 文件 等 中 的 钱包 。 离 线 钱包 也 称 为 冷 
钱包 。 离 线 钱包 比 在 线 钱 包 更 安全 ， 因 为 要 价钱 的 人 必须 能 够 访问 物理 内 存 。 离 线 存 储 的 问题 是 ， 用 户 需 要 找到 一 个 不 会 意外 删 
除 或 者 忘记 的 位 置 ， 或 者 让 其 他 任何 人 都 不 能 访问 的 位 置 。 如 果 想 长 期 安全 地 保管 钱 款 ,许多 人 会 在 纸 上 和 存储 钱包 ， 然 后 把 纸 放 
入 保险 箱 。 如 果 想 从 账 己 频繁 地 友 送 钱 蒜 ， 则 可 以 存在 市 有 密码 保护 的 内 存盘 和 保险 箱 里 。 用 数字 设备 存储 钱包 有 点 危险 ， 因 为 
数字 设备 可 能 随时 坏 掉 ， 那 样 束 无 法 访问 钱包 了 。 这 残 是 为 什么 既 要 存在 内 存盘 中 ， 还 应 当 存 在 保险 箱 里 。 根 据 需 求 的 不 同 ， 用 
尸 还 可 以 找到 更 好 的 解决 万 法 ， 但 是 必须 确保 万 法 安全 ， 且 不 会 意外 地 丢失 对 钱包 的 访问 路 径 。 


5.2 Hooked-Web3-Provider£zs[]EthereumJS-tx[z 


到 目前 为 止 ，Web3.js 库 的 sendTransaction () 方法 的 所 有 例子 都 使 用 以 太 坊 节点 出 现 的 from 地 址 ， 因 此 以 太 坊 节点 能 够 
在 广播 之 前 签署 交易 。 但 是 如 果 用 户 把 钱包 的 私 钥 存储 在 其 他 地 方 ，geth 惑 友 现 不 了 它 。 因 此 在 这 种 情况 下 ， 需 要 使 用 
web3.eth.sendRawTransaction () 方法 广播 交易 。 


web3.eth.sendRawTransaction () 用 于 广播 原始 交易 ， 也 就 是 说 ， 用 户 不 得 不 编写 代码 来 创建 和 签署 原始 交易 。 以 太 坊 
节点 将 直接 广播 ， 而 不 对 交易 做 任何 其 他 操作 。 但 是 使 用 web3.eth.sendRawTransaction () 编写 代码 以 广播 交易 并 非 易 事 ， 
因为 它 要 求生 成 数据 部 分 、 创 建 原始 交易 并 签署 交易 。 


Hooked-Web3-Provider 库 提供 目 定义 程序 提供 方 (custom provider) ， 它 使 用 HTTP 与 geth 通 信 。 这 个 提供 方 的 独特 之 
处 在 于 ， 它 允许 使 用 密 钥 签署 合约 实例 的 SendTransaction () 调用 ， 因 此 不 再 需要 创建 交易 的 数据 部 分 了 。 自 定义 程序 提供 方 
事实 上 重 写 了 web3.eth.sendTransaction () 方法 的 实现 ， 所 以 基本 上 它 允 许 签署 合约 实例 的 sendTransaction () 调用 以 及 
web3.eth.sendTransaction () 调用 。 合 约 实例 的 sendTransaction () 方法 在 内 部 生成 交易 数据 ， 并 调用 


web3.eth.sendTransaction () 广播 交易 。 


EthereumjJS 是 一 系列 与 以 太 坊 相关 的 库 。EthereumjJS-tx 是 其 中 之 一 ， 它 提供 了 多 种 与 交易 相关 的 APl， 例 如 ， 人 允许 创建 


原始 交易 、 签 署 原始 交易 、 检 查 交 易 是 否 正 确 使 用 密 钥 进 行 了 签名 ， 等 等 。 


这 两 个 库 对 node.js 和 客户 问 JavaScript 可 用 。 访 问 https://www.npmjs.com/package/hooked-web3-provider 可 下 载 
Hooked-Web3-Provider, iiR]https://www.npmjs.com/package/ethereumjs-txnJ F&xEthereum]JS-tx, 


在 写本 书 时 ，Hooked-Web3-Provider 的 最 新 版 本 是 1.0.0，EthereumJS-tx 的 最 新 版 本 是 1.1.4。 


下 面 来 看 如 何 使 用 这 些 库 从 一 个 不 由 geth 管 理 的 账 尸 友 送 交易 。 


var provider = new HookedWeb3Provider(í 
hosts "https;/ localhost: 8545", 
transaction signer: { 
hasAddress: function(address, callback) { 
Callback (null, true): 
s 
signTransaction: function(tx_params, callback) { 
var rawTx = { 
gasPrice: web3.toHex(tx_params.gasPrice), 
gasLimit: web3.toHex(tx_params.gas), 
value: web3.toHex (tx_params.value) 
from: tx_params.from, 
to: tx_params.to, 
nonce: web3.toHex(tx params.nonce) 


; 


var privateKey - 
EthJS.Util.toBuffer('0x1a56e47492bf3df9c9563fa7f66e4e032c661de9d68c3f£36£f358 
e6bc9a9f69f2', 'hex'); 

var tx - new EthJS.Tx(rawTx); 

tx.sign(privateKey); 


callback (null, tx.serialize().toString('hex')); 


} 
i); 
var web3 - new Web3 (provider); 


web3.eth.sendTransaction ({ 

from: "0xba6406ddf8817620393ab1310ab4d0c2deda714d", 
to: "Ox2bdbec0ccad70307a00c66de02789e394c2c74d8549", 
value: web3.toWei("0.1", "ether"), 

gasPrice: "20000000000", 

gas: "21000" 

y; function(error, result) { 

console.log(error, result) 


;) 


上 述 代码 的 执行 过 程 如 下 : 


1) 创建 一 个 HookedWeb3Provider 实 例 (由 Hooked-Web3-Provider 库 提供 ) 。 该 构 迄 图 数 有 一 个 对 象 ， 这 个 对 象 有 两 
个 必须 提供 的 属性 host 和 transaction signer。host 是 节点 的 HTTP URL, transaction signer 是 自 定义 服务 提供 方 用 于 签署 交 
易 的 通信 对 象 。 


2) transaction signer 对 象 有 两 个 属性 hasAddress 和 signTransaction。 调 用 hasAddress 检 查 交 易 是 否 可 以 签署 ， 即 检查 
交易 签署 者 是 否 有 from 地 址 账户 的 私 铀 。 该 方法 接收 地 址 和 一 个 回调 函数 。 如 果 找 不 到 地 址 私 铀 ， 回 调 阔 数 的 第 一 个 实 参 应 当 
昔 误 信 息 ， 第 二 个 实 参 应 当 是 false; 如 果 找 到 地 址 私 铀 ， 第 一 个 实 参 应 当 是 null， 第 二 个 实 参 应 当 是 true。 
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3) 如 果 发 现 地 址 私 钥 ， 则 自 定义 程序 提供 方 调用 signTransaction 方 法 得 到 交易 签名 。 该 方法 有 两 个 参数 ， 即 交易 参数 和 回 
调 辫 数 。 在 这 个 方法 中 ， 首 先 将 交易 参数 转换 为 原始 交易 参数 ， 也 就 是 说 ， 将 原始 交易 参数 数值 编译 为 十 六 进 制 的 字符 串 。 然 后 
创建 一 个 缓存 存储 私 铀 。 缓 人 存 使 用 EthJSs.UtiltoBuffer O 方法 创建 ， 该 方法 是 EthereumJS-util 库 的 一 部 分 。EthereumJS-util 
库 由 EthereumJs-tx 库 导入 。 接 下 来 创建 一 个 原始 交易 并 签名 ， 之 后 编 序 号 ， 并 转换 成 十 入 进 制 字符 串 。 最 后 需要 用 回调 函数 为 
目 定 义 服 务 提 供 方 提供 等 名 原始 交易 的 十 六 进 制 字符 串 。 该 方法 友 生 错误 时 ， 回 调 函 数 的 第 一 个 实 参 应 当 是 一 个 错误 信息 。 


4) 自 定 义 服务 提供 方 进 行 原始 交易 ， 并 用 web3.eth.sendRawTransaction () 进行 广播 。 


5) 调用 web3.eth.sendTransaction 国 数 向 另 一 个 账户 友 送 奉 干 以 太 币 。 这 里 需要 提供 nonce 以 外 的 所 有 交易 参数 ， 因 为 目 
定义 服务 提供 方 可 以 计算 nonce。 此 前 ,许多 参数 都 是 可 选项 ， 因 为 把 它们 留 给 了 以 大 坊 节 点 进行 计算 ， 但 是 由 于 这 里 要 自己 签 
署 ， 就 需要 提供 所 有 交易 参数 。 如 果 交 易 没 有 任何 相关 数据 ， 则 gas 总 是 21000。 


e 公 钥 的 情况 呢 ? 


在 上 述 代 码 中 ， 并 未 提 及 签署 地 址 的 公 钥 。 如 果 矿 工 没 有 公 钥 ， 该 如 何 验证 交易 的 真实 性 ? 矿工 使 用 了 ECDSA 算 法 的 一 个 
独特 属性 ， 该 属性 允许 矿工 通过 信息 和 签名 计算 公 钥 。 在 交易 中 ， 信 息 表 示 交 易 意 向 ， 签 名 用 于 发 现 签 署 信息 时 是 否 使 用 了 正确 


的 私 钥 。 这 是 ECDSA 算 法 的 独特 之 处 。Ethereum]JS-tx 提 供 一 个 API 用 于 验证 交易 。 


5.3 ”分 层 确 定性 钱包 


分 层 确 定性 钱包 (Hierarchical Deterministic wallet，HD 钱 包 ) 是 由 一 个 单独 的 起 点 ( 称 为 seed， 即 种 子 ) 衍生 的 地 址 和 
密 钥 的 集成 系统 。 确 定性 表明 对 于 相同 的 seed 生 成 相同 的 地 址 和 密 钥 ， 分 层 表 明 地 址 和 密 钥 以 相同 顺序 生成 。 它 使 备份 和 存储 
多 个 账户 变 得 容易 ， 因 为 用 户 只 需要 和 存储 seed， 而 不 用 存储 单个 密 钥 和 地 址 。 


e 为 什么 用 户 需要 多 个 账户 ? 


为 什么 用 户 需要 多 个 账户 ?因为 要 隐藏 财产 。 账 户 余 额 在 区 块 链 中 公开 可 用 ， 所 以 ， 如 果 用 户 A 与 用 户 B 分 享 地 址 以 接收 一 
些 以 太 币 ， 则 用 户 B 可 以 查看 该 地 址 中 有 多 少 以 太 币 。 因 此 ， 用 户 通常 在 多 个 账户 中 存 有 财产 。 


HD 钱包 有 多 种 类 型 ,它们 的 种 子 格式 以 及 生成 地 址 和 密 钥 的 算法 不 同 ， 例 如 BIP32、Armory、Coinkite、Coinb.in 等 。 


的 什么 是 BIP32、BIP44 和 BlIP39? 


比特 币 改 进 提 议 (Bitcoin Improvement Proposal, BIP) 是 一 个 为 比特 币 社 区 提供 信息 的 设计 文档 ， 它 描述 比特 币 的 一 个 新 功 
能 或 者 其 过 程 或 者 环境 。BIP 应 当 为 该 功能 提供 一 份 简 明 技 术 规 范 和 功能 基本 原理 。 在 写本 书 时 ， 有 152 个 BIP。BIP32 和 BIP39 分 


别提 供 关 于 实现 HD 钱包 和 助 记 种 子规 范 (mnemonic seed specification) 的 算法 信息 。 


如 要 学 习 更 多 BIP 的 相关 知识 ， 请 访问 https://github.com/bitcoin/bips。 


5.4 INTERR 


不 对 称 的 加 密 算法 定义 密 钥 的 性 质 以 及 生成 密 钥 的 方法 ， 因 为 密 钥 需要 相互 天 联 。 例 如 ，RSA 密 钥 生 成 算法 是 确定 性 的 。 

对 称 的 加 密 算法 只 定义 密 钥 长 度 。 密 钥 由 用 户 来 生成 。 有 多 种 算法 生成 密 钥 ， 其 中 一 种 是 KDF。 

密 钥 衍生 函数 (KDF) 是 用 于 从 一 些 密 值 (例如 主 密 钥 、 密 码 ) 中 衍生 对 称 密 钥 的 确定 性 算法 。 有 多 种 类 型 的 KDF， 例 如 
bcrypt、crypt、PBKDF2、scrypt、HKDF 等 。 如 要 学 习 更 多 KDF 的 相关 知识 ， 请 访 
[E]https://en.wikipedia.org/wiki/Key derivation function, 


o AT M—4A BBE MS PBA, "Y AUT HE (concatenate) 和 递增 (increment) 运算 。 


AT SA eT ES TER. ATES, Pe SSA, SSA eA THe 
SURE, GASASANG, BREDELUSNUSSJJBGHTUEdUIGE. E FARBA ATERA, AELH, BT 
储 也 有 风险 一 一 有 可 能 被 盗 。PBKDF2 是 一 个 基于 密码 的 密 钥 衍生 函数 的 例子 。 


主 密 钥 或 者 密码 难以 使 用 强力 攻击 破解 ; 因此， 如果 你 想 从 主 密 钥 或 者 密码 生成 一 个 对 称 密 钥 ， 可 以 使 用 不 以 密码 为 基础 的 
密 钥 衍生 函数 ， 例 如 HKDF。HKDF 比 PBKDF2 快 得 多 ，。 
e 为 什么 使 用 KDF ， 而 不 使 用 哈 希 函 数 ? 


哈 希 功能 的 输出 可 以 当 作对 称 密 钥 加 窗 技 术 使 用 。 所 以 你 肯定 在 奇怪 为 什么 需要 KDF。 如 果 使 用 的 是 主 密 钥 、 密 码 或 者 强 
密码 ， 那 么 使 用 一 个 哈 希 函数 就 行 了 。 例 如 ，HKDF 仅 使 用 哈 希 函数 生成 密 铜 。 但 是 如 果 不 能 保证 用 户 使 用 强 密码 ， 最 好 使 用 哈 


Ay yf Hit HE 8 BAY 


5.5 LightWallet 


LightWallet 是 一 个 实现 BIP32、BIP39 和 BlIP44 的 HD 钱 包 。LightWallet 提 供 APl 来 创建 和 签署 交易 ， 或 者 使 用 LightWallet 
生成 的 地 址 和 密 钥 加 密 和 解密 数据 。 


LightWallet API 被 分 成 4 个 命名 空间 ， 即 keystore、signing、encryption 和 txutils。signing、encrpytion 和 txutils 分 别 用 


来 提供 API 以 签名 交易 、 非 对 称 的 密码 和 创建 交易 ， 而 Keystore 命 名 空间 用 于 创建 keystore、 生 成 种 子 等 。keystore 是 一 个 存储 
加 密 种 子 和 密 钥 的 对 象 。 如 果 使 用 Hooked-Web3-Provider，keystore 命 名 空间 实现 交易 签名 者 方法 ， 设 万 法 要 求 签 署 
we3.eth.sendTransaction () 调用 。 因 此 keystore 命 名 空间 对 于 在 其 中 友 现 的 地 址 可 以 目 动 创建 和 签署 交易 。 实 际 

上 ，LightWallet 的 主要 目的 是 成 为 Hooked-Web3-Provider 的 一 个 等 名 提供 方 。 


可 以 配置 密 钥 存 储 实例 ， 来 创建 和 签署 交易 或 者 加 密 和 解密 数据 。 签 署 交 易 用 secp256k1 参 数 ， 加 密 和 解密 用 curve25519 


参数 。 


Ww 


LightWallet 的 种 子 是 一 个 12 词 的 助 记 符 ， 容 易 记 住 但 不 容易 进行 破解 。 它 不 是 任意 12 个 词 ， 而 是 LightWallet 生 成 的 种 子 。 
LightWallet 生 成 的 种 子 在 选择 词 和 其 他 东西 方面 有 特定 的 属性 。 


HD 行 生路 径 


HD 衍 生路 径 是 一 个 字符 串 ， 可 以 使 多 个 加 密 货币 (假设 它们 使 用 相同 的 签名 算法 ) 、 多 个 区 块 链 和 多 个 账户 等 的 处 理 变 得 


ES 
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HD 衍 生路 径 需要 多 少 参数 残 可 以 有 多 少 参数 ， 还 可 以 对 参数 使 用 不 同 的 数值 ， 可 以 产生 不 同 的 地 址 群 和 相关 密 铀 。 


LightWallet 默 认 使 用 m/0V0V0' 衍 生路 径 。 这 里 ，/n "是 参数 ，n 是 参数 值 。 
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每 个 HD 衍 生路 径 都 有 curve 和 purpose。purpose 可 以 是 sign 或 者 asymEncrypt。sign 表 示 该 路 径 用 于 签署 交 
，asyEncrypt 表 示 该 路 径 用 于 加 密 和 解码 。curve 表 示 ECC 的 参数 。 为 了 签名 ， 参 数 必须 是 secp256k1; 对 于 不 对 称 加 
，CuUrve 必 须 是 curve25591， 因 为 LightWallet 出 于 自身 利益 强迫 我 们 使 用 这 些 参 数 。 
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5.6 ”创建 钱包 服务 


我 们 已 经 学 习 了 关于 LightWallet 的 理论 ， 现 在 是 时 候 用 LightWallet 和 Hooked-Web3-Provider 创 建 钱 包 服 务 了 。 钱 包 服 
务 将 允许 用 户 生成 独一无二 的 种 子 ， 显 示 地 址 和 相关 余额 ， 最 后 将 允许 用 户 上 友 大 以 太 币 给 其 他 账户 。 所 有 操作 都 在 客户 痕 上 进 
行 ， 这 样 比较 容易 取得 用 户 的 信任 。 用 户 必 须 记 住 种 子 或 者 把 它 和 存储 在 某 个 地 方 。 


5.6.1 ”必要 条 件 


在 开始 创建 钱包 服务 之 前 ， 应 确保 运行 geth 开 友 实 例 (BSA) ， 它 已 启动 了 HTTP-RPC 服 务 器 ， 人 允许 来 自任 何 域 名 的 客 
尸 端 请求， 最 后 解锁 账 忆 0。 运行 下 面 的 代码 : 


geth --dev --rpc --rpccorsdomain "*" --rpcaddr "0.0.0.0" --rpcport 
"8545" --mine --unlock-z0 


其 中 ，--rpccorsdomain 用 于 允许 一 些 特 定 域 与 geth 通 信 。 需 要 提供 一 个 以 空格 分 隔 的 域名 列表 ， 例 
4] "http://localhost: 8080 https://mySite.com*" , BAXA E. --rpcaddrzezsgethflg2ss&n] LARIGATRBANIP3OOHE, SA 
认 的 是 127.0.0.1， 所 以 如 果 它 是 一 个 托 党 服务 器 ， 融 不 能 使 用 服务 器 的 公共 IP 地 址 到 达 它 。 因 此 ， 将 它 的 值 改 为 0.0.0.0， 这 表 


示 该 服务 器 可 以 使 用 任何 IP 地 址 到 达 。 


5.6.2 ME 


在 本 章 的 练习 文件 中 ， 你 将 发 现 Final 和 Initial 两 个 目录 。Final 包 含 项 目的 最 终 源 代码 ， 而 Initial 包 含 可 以 用 于 迅速 创建 应 用 
的 空 的 源 代码 文件 和 库 。 
o 为 了 测试 Final 目录 ， 需 要 在 其 中 运行 hpm install， 然 后 使 用 Final 目 录 中 的 node app.js 命 令 运 行 该 应 用 。 


在 Initial 目 录 中 ， 你 将 上 友 现 一 个 public 目 录 和 两 个 文件 (app.js 和 package.json) 。package.json 包 含 应 用 的 后 端 相 关内 
容 ， 把 后 端 源 代 码 放 在 app.js 里 。 


public 目 录 包 含 与 前 并 相关 的 文件 。 在 public/css 中 会 发 现 bootstrap.min.css， 它 是 bootstrap 库 ; 在 public/html 中 会 发 现 
index.html， 把 应 用 的 HTML 代 码 放 在 这 里 ; 在 public/js 目 录 中 将 发 现 Hooked-Web3-Provider、web3js 和 LightWallet 的 .js 文 
件 。 在 public/js 中 还 会 发 现 一 个 main.js 文 件 ， 把 应 用 的 前 端 /S 代 码 放 在 这 里 。 


5.6.3 ”创建 后 端 


先 来 创建 App 后 端 。 首 先 ， 在 Initial 目 录 中 运行 Npm install， 为 后 闹 安 六 所 需 相 关内 容 。 
运行 快捷 服务 并 用 于 index.html 文 件 和 静态 文件 的 完整 后 端 代码 如 下 : 


var express = require ("express"); 
var app = express () ; 


app.use(express.static("public")); 
app.get("/", function(req, res) { 
res.sendFile(__dirname + "/public/html/index.html"); 


;) 


app.listen(8080); 


上 述 代码 无 须 解释 。 


5.6.4 QRT 


现在 开始 创建 App 前 端 。 前 端 所 包括 的 主要 功能 有 生成 种 子 、 显 示 种 子 地 址 和 发送 以 太 币 。 


编写 应 用 的 HTML 人 代码。 把 如 下 代码 放 入 index.html 文 件 中 : 


<!DOCTYPE html» 
<html lang="en"> 
<head> 
<meta charset-"utf-8"» 
«meta name="viewport" content="width=device-width, initial- 
scale=1, shrink-to-fit=no"> 
<meta http-equiv="x-ua-compatible" content="i1e=edge"> 
<link rel="stylesheet" href="/css/bootstrap.min.css"> 
</head> 
<body> 
«div class="container"> 
<div class="row"> 
«div class="col-md-6 offset-md-3"» 
CDI 
«div class-"alert alert-info" id="info" role="alert"> 
Create or use your existing wallet. 
</div> 
<form> 
<div class-"form-group"» 
«label for="seed">Enter 12-word seed</label> 
<input type="text" class-"form-control" 
id="seed"> 


</div> 
«button type="button" class="btn btn-primary" 
onclick="generate_addresses()">Generate Details</button> 


<button type="button" class="btn btn-primary" 
onclick="generate_seed()">Generate New Seed</button> 
</form> 
<DE> 
<h2 class="text-xs-center">Address, Keys and Balances 
of the seed</h2> 
col i i 
< Gl 
enr 
<h2 class-"text-xs-center"»Send ether</h2> 
<Lorm> 
«div class="form-group"> 
<label for="addressi">From address</label> 
<input type="text" class-"form-control" 
id="addressi"> 
</div> 
«div class="form-group"> 
<label for="address2">To address</label> 
<input type="text" class-"form-control" 
id="address2"> 


zJdiv> 
«div class-"form-group"» 
«label for="ether">Ether</label> 
<input type="text" class-"form-control" 
id-"ether"» 


</div> 
<button type="button" class="btn btn-primary" 
onclick="send_ether()">Send Ether</button> 
</form> 
</div> 
</div> 


«/div» 

<script Sros"/]s/web3.min.]8"5«/scorlpt» 

«script src-"/js/hooked-web3-provider.min.js"»«/script» 
«script src="/js/lightwallet.min.js"></script> 
«sorlpot gSprget/]s/malin.]s"»«7Ssocript» 


</body> 
</html> 


上 述 代码 的 执行 过 程 如 下 : 

1) 把 Bootstrap 4 样式 表 排 入 队列 。 

2) 显示 一 个 信息 框 ， 上 面 将 显示 多 个 信息 。 

3) 得 到 一 个 表单 ， 上 面 有 一 个 输入 框 和 两 个 按钮 。 输 入 框 用 于 输入 seed 或 者 在 生成 新 的 seed 时 显示 seed。 


4) Generate Details 按 钮 用 于 显示 地 址 ，Generate NewSeed 按 钮 用 于 生成 一 个 新 的 、 独 一 无 二 的 seed。 用 户 单 击 
Generate Details 按 钮 就 调用 generate Addresses () 方法 ， 单 击 Generate New Seed 按 钮 就 调用 generate seed () 方法 。 


5) 这 时 就 有 了 一 个 空 的 有 序列 表 。 当 用 户 单 击 Generate Details 按 钮 时 ， 将 动态 显示 seed 地 址 、 余 额 和 相关 私 钥 。 


—Á 


6 
址 之 一 。 


最 后 有 另外 一 张 表单 ， 其 中 有 from 地 址 、to 地 址 和 要 转账 的 以 太 币 数量 。from 地 址 必须 是 当前 未 排序 列表 中 显示 的 地 


—Á 


现在 编写 HTML 代 码 调用 的 每 个 函数 的 实现 。 百 先 编 写 代 码 ， 生 成 一 个 新 的 seed。 将 这 段 代 码 放 入 mainjs 文 件 : 
function generate seed() 

1 

var new seed = lightwallet.keystore.generateRandomSeed(); 


document.getElementById("seed").value = new seeg; 


generate addresses(new seed); 


j 


Keystore 命 名 空间 的 generateRandomSeed () 方法 用 于 生成 一 个 随机 seed。 它 用 接受 一 个 可 选 参数 ， 即 一 个 表示 额外 的 
HFS. 
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别提 供 的 随机 数 生成 器 。 


生成 一 个 独特 的 seed 需 要 非常 高 的 。LightWallet 内 置 了 生成 唯一 seed 的 方法 。LightWallet 生 成 录 使 用 的 算法 取决 于 环 
iS, GEURA EREBETA, Sn] cEBABJAS AgenerateRandomSeed () ， 它 将 在 内 部 与 
generateRandomSeed () 4^FkBSIBttér9Hg. 


生成 随机 seed 之 后 ， 调 用 generate Addresses 方 法 。 该 方法 以 seed 作 为 参数 ， 并 在 其 中 显示 地 址 。 在 生成 地 址 之 前 ， 它 会 
问 用 户 想 要 多 少 个 地 址 ，。 


generate Addresses () 方法 的 实现 如 下 。 把 如 下 代码 放 入 main.js 文 件 中 : 


var totalAddresses = 0; 


function generate addresses(seed) 


1 


if(seed -- undefined) 


1 


seed = document.getElementById("seed").value; 


j 


if(!lightwallet.keystore.isSeedValid(seed)) 
1 


document.getElementById("info").innerHTML = "Please enter a valid seed"; 
return; 

} 
totalAddresses = prompt ("How many addresses do you want to generate"); 


if(!Number.isInteger(parseInt (totalAddresses) ) ) 

{ 

document.getElementById("info").innerHTML = "Please enter valid number of 
addresses"; 

return; 


j 


var password = Math.random().toString(); 


lightwallet.keystore.createVault ({ 
password: password, 
seedPhrase: seed 
tL IuUDnGclon AGrE, KSF 4 
ks.keyFromPassword(password, function (err, pwDerivedKey) { 


if (err) 

{ 

document.getElementById("info").innerHTML = err; 

j 

else 

1 

ks.generateNewAddress (pwDerivedKey, totalAddresses); 
var addresses = ks.getAddresses(); 


var web3 - new Web3 (new 
Web3.providers.HttpProvider("http://localhost:8545")); 


var DEML = TMi 
for(var count = 0; count < addresses.length; count++) 
{ 
var address = addresses [count]; 
var private_key = ks.exportPrivateKey (address, pwDerivedKey); 
var balance = web3.eth.getBalance("0x" + address); 
html = html + "<li>"; 


html = html + "<p><b>Address: </b>0x" + address + "</p>"; 
html html + "<p><b>Private Key: </b>0x" + private key + "</p>"; 
html html + "<p><b>Balance: </b>" + web3.fromWei(balance, "ether") + 
" etherc/p»"; 
html = html + "</li>"; 
j 


document.getElementById("list").innerHTML = html; 


上 述 代码 的 执行 过 程 如 下 : 
1) 首先 有 一 个 变量 totalAddresses， 它 存储 用 户 希 望 生成 的 地 址 总 数 。 


2) 检查 参数 seed 是 否定 义 了 。 如 果 没 有 定义 ， 则 从 输入 栏 抓 取 seed。 这 样 做 ，generate Addressess () 方法 可 以 用 于 显 
示 信 息 seed， 如 果 用 户 单 击 Generate Details 按 钮 ， 还 同时 生成 一 个 新 的 seed。 


3) 使 用 isSeedValid () 方法 验证 keystore 命 名 空间 的 seed。 
4) 请 用 户 输 入 想 要 生成 和 展示 多 少 地 址 并 进行 验证 。 


5) keystore 命 名 空间 中 的 私 钥 总 是 加 密 存 储 的 。 在 生成 密 铀 时 ， 需 要 进行 加 密 ; 在 釜 署 交易 时 ， 需 要 解密 。 人 衍生 对 称 加 密 
密 钥 的 密码 可 以 由 用 户 输入 ， 或 者 提供 一 个 随机 字符 串 作 为 密码 。 为 了 使 用 户 体验 更 好 ， 生 成 一 个 随机 字符 串 ， 将 它 用 作 密 码 。 
对 称 加 密 密 钥 没有 存储 在 Keystore 售 名 空间 里 ， 因 此 只 要 进行 与 私 铀 相 天 的 操作 ， 例 如 生成 密 铀 、 访 问 密 钥 等 ， 残 需要 从 密码 生 
成 密 钥 。 


6) 使 用 createVault 方 法 创建 keystore 实 例 。createVault 用 一 个 对 象 和 一 个 回调 了 销 数 作为 参数 。 对 象 可 以 有 4 种 属性 : 
password、seedPharse、salt 和 hdPathString。password 是 必 选 项 ， 其 他 的 都 是 可 选项 。 如 果 不 提供 seedPharse， 它 会 生成 
和 使 用 一 个 随机 seed。 拼 授 salt 与 password， 以 提高 对 称 密 钥 加 密 技术 的 安全 性 ， 因 为 攻击 者 不 仪 要 找到 password 还 得 找到 


salt。 如 果 不 提供 salt， 它 束 会 随机 生成 。keystore 命 名 空间 存储 未 加 密 的 salt。hdPathString 用 于 为 keystore 命 名 空间 提供 默 
认 人 衍生 路 径 ， 即 生成 地 址 、 签 署 交 易 等 。 如 果 不 提 供 衍 生路 径 ， 则 使 用 该 衍生 路 径 。 如 果 不 提 供 hdPathstring， 则 默认 值 为 
m/0V07V0'。 这 个 衍生 路 径 的 默认 目的 是 签名 。 可 以 创建 新 的 衍生 路 径 或 者 使 用 keystore 实 例 的 addHdDerivationPath () 方法 
重 写 当前 衍生 路 径 的 purpose。 还 可 以 使 用 keystore 实 例 的 setDefaultHdDerivationPath () 方法 改变 默认 衍生 路 径 。 最 后 ， 
一 旦 keystore 命 名 空间 被 创建 ， 束 通过 回调 消 数 返回 实例 。 所 以 ， 这 里 仅 用 keyword 和 和 seed 创 建 了 一 个 keystore。 


7) 生成 用 户 指定 数量 的 地 址 及 其 相关 密 钥 。 从 一 个 seed 中 可 以 生成 数 百 万 个 地 址 ， 因 为 keystore 不 知道 用 户 想 生 成 多 少 个 
地 址 ， 所 以 在 此 之 前 不 会 生成 任何 地 址 。 在 创建 keystore 之 后 ， 使 用 keyFromPassword 方 法 从 密码 中 生成 对 称 密 钥 ， 然 后 调用 
generateNewAddress () 方法 生成 地 址 及 其 相 天 密 钥 。 


8) generateNewAddress () 有 3 个 实 参 ， 即 密码 衍生 的 密 钥 、 生 成 地 址 的 数量 和 衍生 路 径 。 因 为 没有 提供 衍生 路 径 ， 它 
使 用 keystore 的 默认 衍生 路 径 。 如 果 多 次 调用 generateNewAddress () ， 它 会 从 在 最 后 一 次 调用 中 创建 的 地 址 重新 开始 。 例 
如 ， 如 果 调 用 该 方法 两 次 ， 每 次 生成 两 个 地 址 ， 则 将 得 到 前 四 个 地 址 。 


9) 使 用 getAddresses () 获取 存储 在 keystore 上 的 全 部 地 址 。 

10) 使 用 exportPrivateKey 方 法 解码 和 检索 地 址 私 钥 。 

11) 使 用 web3.eth.getBalance () 获取 地 址 余额 。 

12) 在 未 排序 的 列表 中 显示 全 部 信息 。 

上 面 介 绍 了 从 seed 生 成 地 址 及 其 私 钥 的 方法 。 现 在 编写 send ether () 方法 的 实现 ， 该 方法 用 于 从 一 个 由 seed 生 成 的 地 址 
发 送 以 太 币 。 

相关 代码 如 下 。 将 这 段 代 码 放 入 mainjjs 文 件 : 


function send ether() 


{ 


var seed = document.getElementById("seed").value; 


if(!lightwallet.keystore.isSeedValid(seed)) 

{ 

document.getElementById("info").innerHTML = "Please enter a valid seed"; 
return; 


j 
var password - Math.random().toString(); 


lightwallet.keystore.createVault ({ 
password: password, 
seedPhrase: seed 
}, function (err, ks) { 
ks.keyFromPassword(password, function (err, pwDerivedKey) { 
if(err) 
{ 
document .getElementBylId("info") .inmnerHTML = err; 
} 
else 
{ 


ks.generateNewAddress (pwDerivedKey, totalAddresses) ; 


ks.passwordProvider = function (callback) { 
callbackinull, password); 


ji 


var provider = new HookedWeb3Provider ({ 
hosts "fhectp://loealhosti8545", 
transaction_signer: ks 


DF 


var web3 = new Web3 (provider); 
var from = document.getElementById("address1").value; 
var to = document.getElementById("address2").value; 
var value = web3.toWei(document.getElementById("ether").value, 
"ether"); 


web3.eth.sendTransaction({ 
from* from, 
LOT t; 
value: value, 
gas: 21000 
), function(error, result) { 
if (error) 
{ 
document .getElementById("info") .innerHTML 
} 
else 
{ 
document .getElementById("info") .innerHTML = "Txn hash: " + result; 
} 
}) 


error; 


P; 


上 述 代码 直到 由 seed 生 成 地 址 的 部 分 都 无 须 解释 。 然 后 给 ks 的 passwordProvider 属 性 分 配 一 个 回调 阔 数 。 该 回调 函数 在 签 
署 交易 时 被 调用 ， 以 获取 密码 解码 私 铀 。 如 果 不 提 供 ，LightWallet 就 会 提示 用 户 输入 密码 。 此 时 ， 通 过 传送 keystore 作 为 交易 
釜 署 者 创建 一 个 HookedWeb3Provider 实 例 。 当 上 自 定 义 服务 提供 方 想 签 署 交 易 时 ， 它 调用 ks 的 hasAddress 方 法 和 
signTransactions 方 法 。 如 果 要 签署 的 地 址 不 在 生成 的 地 址 之 中 ，Kks 将 向 自 定义 服务 提供 方 返回 错误 。 最 后 使 用 
web3.eth.sendTransaction 方 法 友 送 一 些 以 太 币 。 


5.6.5 ”测试 


钱包 服务 的 创建 已 经 完成 了 ， 让 我 们 测试 一 下 ， 和 确保 它 像 预想 的 那样 工作 。 首 先 ， 在 Initial 目 录 中 运行 node appjs， 然 后 
在 浏览 器 中 访问 http://localhost: 8080， 运 行 界面 如 图 5-11 所 示 。 


Create or use your existing wallet. 


Enter 12-word seed 


Generate Details Generate New Seed 


Address, Keys and Balances of the 
seed 





Send ether 


From address 


To address 


Ether 





Send Ether 


图 5-1 


单 击 Generate New Seed 按 钮 ， 生 成 一 个 新 的 seed。 提 示 输 入 一 个 数字 ， 代 表 要 生成 地 址 的 数量 。 可 以 输入 任何 数字 ， 但 
是 为 了 实现 测试 目的 ， 给 出 一 个 大 于 1 的 数 。 运 行 界面 如 图 5-2 所 示 。 


Create or use your existing wallet. 


Enter 12-word seed 


mutual obscure inch roast stable silent shine shy mail garbage cradle s 


Generate Details Generate New Seed 


Address, Keys and Balances of the 


seed 
1. Address: Oxe922fec586b0578bb022fe1 48d667d0d37e6306f 





Private Key: 
Oxc8be4ac85648777ba50b1 741c0ea971e3ccddcd6f6309b052be5565b00805f98 


Balance: 0 ether 
2. Address: 0x76e0699914e6cd26e05353e34d52112fd1fa4f2687 


Private Key: 
Ox33a6b1 1f6e308b4c55a6ad392ab926baff1l9d1882228ef08afffee9a6eeabc28 


Balance: 0 ether 


Send ether 


From address 


To address 


Ether 





图 52 


现在 测试 发 送 以 太 币 ， 需 要 发 送 一 些 以 太 币 到 从 coinbase 账 户 中 生成 的 地 址 之 一 。 一 旦 发 送 一 些 以 太 币 到 生成 的 地 址 之 
一 ， 即 单 击 Generate Details 按 钮 更 新 用 户 界面 (Ul) ， 尽 管 并 不 需要 测试 使 用 钱包 服务 发 送 以 大 币 。 确 保 再 次 生成 同一 个 地 
址 。 此 时 的 运行 界面 如 图 5-3 所 示 。 


Create or use your existing wallet. 


Enter 12-word seed 


mutual obscure inch roast stable silent shine shy mail garbage cradle s 


Generate Details Generate New Seed 


Address, Keys and Balances of the 


seed 
1. Address: Oxba6406ddf881 7620393ab1310ab4d0c2deda714d 





Private Key: 
0x1a56e47492bf3df9c9563fa7166e4e032c661de9d68c3f36f358e6bc9a9f69f2 


Balance: 1009.09663936 ether 
2. Address: Ox2bdbec0ccd70307a00c66de02789e394c2c74d549 


Private Key: 
0x053c8a5754ce99e3a909b968b23dcb3314f3c88e16ef00658f0aa3f255579a7a 


Balance: 0.9 ether 


Send ether 


From address 


To address 


Ether 





Send Ether 


在 From address 栏 中 输入 列表 中 有 余额 的 账户 的 地 址 ， 然 后 在 To address 栏 输入 另 一 个 地 址 。 为 了 进行 测试 ， 可 以 输入 显 
示 的 任意 其 他 地 址 。 接 着 输入 一 个 以 太 币 数量 ， 该 值 要 小 于 等 于 地 址 账户 中 以 太 币 的 余额 。 运 行 界面 如 图 5-4 所 示 。 


Create or use your existing wallet. 


Enter 12-word seed 


mutual obscure inch roast stable silent shine shy mail garbage cradle s 


Generate Details Generate New Seed 


Address, Keys and Balances of the 


seed 
1. Address: Oxbae406ddf8817620393ab1310ab4dOc2deda7 14d 





Private Key: 
0x1a56e47492bf3df9c9563fa7f66e4e032c661de9d68c3f36f358e6bc9a9f69f2 


Balance: 1009.09663936 ether 
2. Address: Ox2bdbec0ccd70307a00c66de027896e394c2c7d549 


Private Key: 
0x053c8a5754ce99e3a909b968b23dcb3314f3c88e16ef00658f0aa3f255579a7a 


Balance: 0.9 ether 


Send ether 


From address 


Oxba6406ddf881 7620393ab1310ab4dO0c2deda7 14d 


To address 


Ox2bdbec0ccd70307a00c66de02789e394c2c 7d549 


Ether 


23 





Send Ether 


E 54 


单 击 Send Ether 按 钮 ， 即 可 在 信息 框 中 看 到 交易 哈 希 。 等 待 挖 出 交易 。 同 时 在 很 短 的 时 间 内 ， 可 以 单 击 Generate Details 
按钮 查询 交易 是 人 否 被 挖 出 。 如 果 交 易 被 挖 出 ， 则 运行 界面 如 图 5-5 所 示 。 


如 果 每 件 事 都 和 刚才 解释 的 一 样 ， 那 么 钱包 服务 束 已 经 束 绕 了 。 实 际 上 ， 可 以 把 该 服务 部 署 到 一 个 自 定义 域名 ， 让 公众 使 用 


E. 


Txn hash: 
Oxdebe745a82850cc56e766e228c39d0421adOec6b28543b5ec360b405b20e9bd1le 


Enter 12-word seed 


mutual obscure inch roast stable silent shine shy mail garbage cradle s 


Generate Details Generate New Seed 


Address, Keys and Balances of the 


seed 
1. Address: Oxba6406ddf881 7620393ab1310ab4d0c2deda714d 





Private Key: 
0x1a56e47492bf3df9c9563fa7f66e4e032c661de9d68c3f36f358e6bc9a9f69f2 


Balance: 986.09663936 ether 
2. Address: Ox2bdbec0ccd70307a00c66de02789e394c2c7d549 


Private Key: 
0x053c8a5754ce99e3a909b968b23dcb3314f3c88e16ef00658f0aa3f255579a7a 


Balance: 23.9 ether 


Send ether 


From address 


Oxba6406ddf8817620393ab1310ab4d0c2deda7 14d 


To address 


Ox2bdbec0ccd70307a00c66de02789e394c2c7d549 


Ether 


23 


Send Ether 


5.7 AHA 


IONO 


在 本 章 中 ， 我 们 首先 学 习 了 3 个 重要 的 以 太 坊 库 : Hooked-Web3-Provider, EthereumJS-txfeLightWallet, iX 3e ÆT H 4E VA X. 
坊 节点 之 外 管理 账户 和 签署 交易 。 这 些 库 在 大 多 数 DApp 中 开发 客户 端 时 这 些 库 很 有 用 。 然 后 创建 了 一 个 允许 用 户 管理 账户 的 钱 
包 服 务 ， 这 些 账 户 与 服务 后 端 共 享 私 钥 或 者 与 钱包 相关 的 任何 信息 。 


在 下 一 章 中 ， 我 们 将 创建 创建 智能 合约 部 署 平台 。 


第 6 章 ”创建 智能 合约 部 团 平 合 


有 些 客户 端 可 能 需要 在 运行 时 编译 和 部 署 合约 。 在 所 有 权证 明 DApp 中 ， 我 们 手动 部 署 智能 合约 并 在 客户 端 代码 中 硬 编码 合 
约 地 址 。 但 是 有 些 客户 端 可 能 需要 在 运行 时 部 署 智 能 合约 。 例 如 ， 如 果 客 户 端 让 学 校 在 区 块 链 中 记录 学 生出 勤 情 况 ， 那 么 每 次 注 
册 一 个 新 学 校 都 需要 部 署 智 能 合约 ， 这 样 每 个 学 校 才能 完全 控制 其 智能 合约 。 在 本 章 中 ， 我 们 将 学 习 如 何 使 用 web3:js 编 译 智 能 
合约 ， 并 使 用 web3.js 和 EthereumJS 部 署 智能 合约 。 


在 本 草 中 ， 我 们 将 讲解 以 下 内 容 : 

- 计算 交易 nonce。 

- 使 用 交易 池 JSON-RPC API. 

` 为 合约 创建 和 方法 调用 生成 交易 数据 。 
-估算 交易 所 需 的 gas。 


` 发 现 账户 的 当前 可 用 余额 。 


: 使 用 solcjs 编 译 智能 合约 。 


开发 一 个 编写 、 编 译 和 部 署 智能 合约 的 平台 。 


61 计算 一 个 地 址 的 交易 nonce 


对 于 用 geth 维 护 的 账户 ， 不 需要 担心 nonce 计 数 ， 因 为 geth 可 以 向 交易 添加 正确 的 nonce 并 签名 。 如 果 账 户 不 是 用 geth 管 
理 的 ， 则 需要 自行 计算 nonce。 


为 了 自行 计算 nonce， 可 以 使 用 geth 提 供 的 getTransactionCount 方 法 。 第 一 个 实 参 应 当 是 所 需 的 交易 数 的 地 址 ， 第 二 个 
实 参 是 需要 交易 数 的 那个 区 块 。 我 们 可 以 用 “pending (FE) ”字符 串 作 为 区 块 ， 这 个 区 块 包括 从 当前 挖 出 的 区 块 的 交易 。 正 
如 此 前 的 章节 所 述 ，geth 维 护 一 个 待定 交易 和 排队 交易 的 交易 池 。 为 了 挖 出 一 个 区 块 ，geth 把 待定 交易 从 交易 池 中 取出 ， 并 开 
始 挖 新 的 区 块 。 在 没有 挖 该 区 块 之 前 ， 待 定 交 易 一 直 在 交易 池 中 ， 一 旦 挖 出 来 ， 该 交易 就 从 交易 池 中 删除 。 在 挖 区 块 过 程 中 接收 
到 的 新 iIncoming 交 易 被 放 入 交易 池 ， 在 下 一 个 区 块 中 被 控 。 所 以 当 调 用 getTransactionCount 并 把 “pending” 作 为 第 二 个 实 
参 时 ， 它 不 会 看 交易 闻 里 面 ; 相反 ， 它 整 认 为 该 交易 在 待定 区 块 里 。 


所 以 ， 如 果 想 从 不 锐 geth 管 理 的 账 尸 友 送 交 易 ， 束 要 计算 区 块 链 中 账户 交易 的 思 数 ， 并 和 交易 池 中 的 待定 交易 相 加 。 如 果 
想 使 用 来 自 待 定 区 块 的 待定 交易 ， 则 不 能 得 到 正确 的 nonce， 因 为 交易 被 友 送 给 geth 的 间隔 可 能 只 有 几 秒 ， 而 平均 需要 12 秒 才 
能 在 区 块 链 中 确认 交易 。 


在 前 一 草 中 ， 我 们 用 Hooked-Web3-Provider 向 交易 中 添加 nonce。 不 至 的 是 ，Hooked-Web3-Provider 尝 试 得 到 
nounce 的 方法 并 不 正确 。 它 为 每 个 账户 维护 一 个 计数 器 ， 每 次 从 该 账户 友 送 交易 束 增 加 计数 。 但 如 果 交 易 是 非法 的 (例如 ， 如 
果 交 易 安 试 友 这 比 账户 内 更 多 的 以 太 币 ) ， 它 并 不 能 减少 计数 。 因 此 直到 Hooked-Web3-Provider 被 重 置 (We Pini 
置 ) ， 该 账户 的 其 他 交易 都 在 排队 且 不 会 被 挖 。 如 果 创 建 多 个 Hooked-Web3-Provider 实 例 ， 则 这 些 实例 不 能 彼此 同步 账户 的 
nonce， 所 以 最 终 的 nonce 结 果 可 能 是 错 的 。 但 是 在 向 交易 添加 nonce 之 前 ，Hooked-Web3-Provider 得 到 的 总 是 到 待定 区 块 
的 交易 计数 器 ， 并 使 用 与 计数 器 相 比 较 大 的 那 一 个 。 所 以 如 果 来 自 于 Hooked-Web3-Provider 管 理 的 一 个 账户 的 交易 是 网 络 中 
的 另 一 个 书 点 发 送 的 ， 并 被 待定 区 块 接纳 ， 则 Hooked-Web3-Provider 能 看 到 它 。 但 是 不 能 依赖 整个 Hooked-Web3-Provider 
计算 nonce。 这 对 于 客户 端 应 用 原型 机 制造 很 有 益处 ， 并 适合 在 如 果 没 有 向 网 络 广播 交易 且 Hooked-Web3-Provider 经 常 重 置 
用 户 ， 融 可 以 看 到 和 重新 上 友 送 交易 的 应 用 中 使 用 。 例 如 ， 在 钱包 服务 中 ， 用 户 将 频繁 地 上 载 页 面 ， 所 以 经 单 创建 新 的 Hooked- 
Web3-Provider 实 例 。 如 果 交 易 没 有 裤 广 播 、 不 合法 或 者 没有 被 挖 出 ， 那 么 用 户 可 以 更 新 页 面 并 重新 友 达 人 交易。 


6.2 ”solcjs 概 述 


soldjs 是 用 于 编译 solidity 文 件 的 node.js 库 和 命令 行 工 具 。 它 不 使 用 solc 命 令 行 编译 器 ， 而 是 纯粹 使 用 JavaScript 进 行 编译 ， 
因此 它 的 安装 比 solc 简 单 得 多 。 


Sol|c 是 真实 的 solidity 编 译 器 ， 用 C++ 编写 C++ 代码 使 用 emscripten 被 编译 成 JavaScript。Solc 的 每 一 个 版 本 都 被 编译 成 
JavaScript。 访 问 https://glthub.com/ethereum/solc-bin/tree/gh-pages/bin， 可 以 发 现 每 个 solidity 版 本 的 以 JavaScript 为 
基础 的 编译 器 。solcs 仅 使 用 这 些 编 译 器 中 的 一 种 来 编译 solidity 源 代码 。 这 些 编译 器 在 浏览 器 和 mode.js 环 境 中 都 可 以 运行 。 


0 solidity 的 浏览 器 使 用 这 些 以 JavaScript 为 基础 的 编译 器 编译 solidity 源 代码 。 


6.2.1  zzxsolgjs 


solcjs 可 以 作为 solc 的 npm 包 使 用 。 和 其 他 npm 包 一 样 ，solcjs npm 包 可 以 在 本 地 或 者 全 局 安装 。 如 果 包 安装 在 全 局 ， 则 命 
令 行 工 具 solcjs 可 用 。 因 此 ， 为 了 安装 命令 行 工具 ， 运 行 如 下 命令 : 


npm install -9 solc 

接着 运行 如 下 命令 ， 看 看 如 何 用 命令 行 编译 器 编译 solidity 文 件 : 
solcjs -help 

我 们 不 学 习 solds 命 令 行 工 具 ， 而 是 学 习 用 solds API 编 译 solidity 文 件 。 


i solcjs 默 认 使 用 的 编译 器 版 本 与 其 自身 版 本 匹配 。 人 例如， 如果 安 装 solcjs 的 0.4.8 版 本 ， 则 将 默认 使 用 0.4.8 编 译 器 版 本 进 
行 编译 。 也 可 以 配置 solcjs， 以 使 用 一 些 其 他 的 编译 器 版 本 。 在 写本 书 之 时 ，solcjs 的 最 新 版 本 是 0.4.8。 


6.2.2 solds API 


solcjs 提 供 了 compiler 方 法 ， 用 于 编译 solidity 代 码 。 根 据 源 代码 是 否 有 import (引用 ) ， 该 方法 可 以 用 于 两 种 不 同方 法 : 
如 果 源 代码 没有 import， 则 需要 两 个 实 参 ， 即 第 一 个 实 参 是 字符 串 作 solidity 源 代码 ， 第 二 个 实 参 是 Boolean ， 表 示 是 否 最 优化 
字 节 码 。 如 果 源 字符 串 包 含 多 个 合约 ， 则 将 编译 全 部 。 示 例如 下 : 


var solc = require("solc"); 
var input = "contract x { function g() {} }"; 
var output = solc.compile(input, 1); // 1 activates the optimiser 


for (var contractName in output.contracts) { 
// logging code and ABI 


console.log(contractName + ": " + 
output.contracts[contractName] .bytecode) ; 
console.log(contractName + "; " + 


JSON. parse (output.contracts[contractName] .interface) ); 


j 


如 果 源 代码 包含 对 其 他 合约 的 引用 (imports) , WE—-SLEME-WER, CARES, (REMHAR. PAA 
何 时 编译 器 看 到 一 个 Import 语 句 ， 它 不 会 在 文件 系统 中 寻找 文件 ， 而 是 通过 与 文件 名 匹配 的 键 在 对 象 中 寻找 文件 内 容 。 示 例如 
RB: 


var solc = require("solc"); 


var input = { 
"lib.sol": "library L { function f() returns (uint) { return 7; } Jj", 
"GOnb.sol"s "import "LD SOL "ss contract x 1 function gi. T Lefi) F 7” 
上 7 
var output = solc.compile(ísources: inputj, 1); 
for (var contractName in output.contracts) 
console.log(contractName + ": ”十 


output.contracts[contractName].bytecode); 


如 果 想 在 编译 时 从 文件 系统 读 取 和 被 引用 的 文件 或 者 在 编译 时 解析 文件 内 容 ， 则 compiler 广 法文 持 第 三 个 实 参 ， 即 取 文 件 名 
并 返回 文件 内 容 的 万 法 。 示 例如 下 : 


var solc = require("solc"); 
var input = { 
"CONE. SOL": "Import 'ILb5b.sol*s contract x 1 Punctlon gi) i1 G-E) j| 


Hi 
function findImports(path) { 
if (path === "lib.sol") 
return { contents: "library L { function f() returns (uint) { 
return 7; } }" } 
else 
return { error: "File not found" } 


} 

var output = solc.compile({sources: input}, 1, findImports); 

for (var contractName in output.contracts) 
console.log(contractName + ": " + 

output.contracts[contractName].bytecode) ; 


1. 使 用 不 同 的 编译 器 版 本 


为 了 使 用 不 同 的 solidity 版 本 编译 合约 ， 需 要 用 useVersion 方 法 去 引用 一 个 不 同 的 编译 器 。useVersion 用 一 个 字符 串 ， 该 字 
符 串 表示 存储 了 编译 器 的 Javascript 文 件 名 ， 并 人 在 /node_modules/solc/bin 目 录 中 寻找 该 文件 。 


so|cjs 还 提供 另 一 种 方式 loadRemoteVersion ， 它 用 的 编译 器 文件 名 与 solc-bin 文 件 库 
(https://github.com/etherum/solc-bin) 中 的 solc-bin/bin 目 录 下 的 文件 名 进行 匹配 ， 并 下 载 和 使 用 。 


最 后 ，solcjs 还 提供 了 另 一 个 setupMethods 方 法 ， 它 与 useVersion 类 似 ， 但 是 可 以 从 任意 目录 加 载 编译 器 。 


var solc = require("solc"); 


var solcv047 = solc.useVersion ("v0.4./7.commit.822622cf"); 
var output = solcv011.compile("contract t { function g() {} }", 1); 


solc.loadRemoteVersion('soljson-v0.4.5.commit.b318366e', function(err, 
solcV045) { 
if (err) { 


// An error was encountered, display and quit 


var output = solcV045.compile("contract t { function g() {} }", 1); 
i); 


var SolcV048 = solc.setupMethods (require("/my/10cal/0.4.8.3s")); 
var output = solcV048.compile("contract t { function g() {} }", 1); 


solc.loadRemoteVersion('latest', function(err, latestVersion) { 
if (err) { 
// An error was encountered, display and quit 
} 
var output = latestVersion.compile("contract t { function g() {} }", 
1); 
DF 


为 了 运行 上 述 代 码 ， 首 先 需 要 从 solc-bin repository 下 载 v0.4.7.commit.822622cf.js 文 件 ， 并 将 其 保存 在 
node_modules/solc/bin 目 录 中 。 然 后 需要 下 载 编译 器 文件 版 本 0.4.8， 将 其 保存 在 文件 系统 中 某 处 ， 并 把 setupMethods 调 用 
中 的 路 径 指向 那个 目录 。 


2. 接 入 库 


如 果 solidity 源 代码 引用 库 ， 生 成 的 字 节 码 将 包含 被 引用 库 真实 地 址 的 占 位 符 。 这 些 必须 在 部 署 合约 之 前 ， 通 过 一 个 称 为 接 
A (linking) 的 程序 更 新 。 


solcjs 提 供 了 把 库 地 址 接 入 生成 的 字 节 码 的 linkByteCode 方 法 。 示 例如 下 : 


var solc = require("solc"); 
var input = { 
"lib.sol"s: “Library L i function fi) returns (unt) { return 7; F +"; 
"oont. SOl"; "import l1b.501*'7 Gontract x { function gi) i Lfl } jy" 
ur 
var output = solc.compile(ísources: input}, 1); 
var finalByteCode = solc.linkBytecode(output.contracts["x"].bytecode, { 
"ats “URL adas ssl tes 
3. 更 新 ABI 


合约 ABI 提 供 多 种 信息 ， 这 些 信息 不 包括 合约 的 实现 。 两 种 不 同 版 本 的 编译 器 生成 的 ABI 可 能 不 匹配 ， 因 为 较 高 版 本 比较 低 
版 本 支持 更 多 的 solidity 功 能 ， 所 以 ABIl 中 有 一 些 额外 信息 。 例 如 ， 回 退 消 数 是 在 Solidity 0.4.0 版 本 时 引入 的 ， 所 以 使 用 0.4.0 以 


hice PXBJABUS BBR ELAS, (AXES RAAT 73:805 € TES BRA RE, RATES RAIMA 


改 器 。 所 以 应 当 更 新 AB1， 以 便 让 依赖 于 较 新 Solidity 版 本 ABI 的 应 用 有 关于 合约 的 更 佳 信息 。 


solcjs 提 供 了 用 于 更 新 的 APl。 示 例如 下 : 


var abi = require("solc/abi"); 


var inputABI - 
[t"constant":false,"inputs"sil],."name";"hello","outbuts":Il4i'"namat"i"t*,TEUDe' 


"sEring"Pl,"payable":Talse,"tvpe":"runetion")]; 
var outputABI = abi.update("0.3.6", inputABI) 


其 中 ，0.3.6 表 示 ABI 是 由 0.3.6 版 本 编译 器 生成 的 。 因 为 我 们 正在 使 用 solcjs 版 本 0.4.8， 将 更 新 ABI 以 匹配 编译 器 版 本 生成 的 
ABI， 但 不 能 是 更 高 的 版 本 。 


上 述 代码 的 输出 如 下 : 
[I"GonsEant":tTalse,"1inputs":1]1,"name"s"hello*","oütputs":[Ii"namne":"" "rope": 
:"fallback","payable":t 


"SErinqg":],"bnavable':true,"Evpe"ri"ruüunction" 4 "type" 


rue } | 


6.3 ”创建 合约 部 着 平台 
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账 己 地址 和 私 钥 来 帮助 他 们 部 署 合约 。 


在 开始 创建 应 用 之 前 ， 确 保 在 运行 geth 开 发 实例 (BUA) 时 启动 rpc， 并 在 HTTP-RPC 服 务 端 上 展示 eth、web3 和 txpool 


APlI。 可 以 运行 下 面 的 代码 : 
geth --dev --rpc --rpccorsdomain "*" --rpcaddr "0.0.0.0" --rpcport 
"8545" --mine --rpcapi "eth,txpool,web3" 


6.3.1 项目 结构 

在 本 章 的 练习 文件 中 ， 将 发 现 两 个 目录 : Final 和 Initial。Final 包 含 项 目的 最 终 源 代码 ， 而 Initial 包 含 可 以 用 于 迅速 创建 应 用 
的 空 的 源 代 码 文 件 和 库 。 

0 为 了 测试 Final 目 录 ， 需 要 在 其 中 运行 ppm install。 然 后 ， 使 用 Final 目 录 中 的 node app.js 命 令 运行 该 应 用 。 

在 Initial 目 录 中 ， 将 友 现 一 个 public 目 录 和 两 个 文件 (app.js 和 package.json) 。package.json 包 仿 应 用 的 后 端 相 关内 


容 ，app.js 则 包含 应 用 的 后 端 源 代码 。 


public 目 录 包 含 与 前 问 相 关 的 文件 。 在 public/css 中 会 发 现 bootstrap.min.css， 它 是 Bootstrap 库 ; 在 public/html 中 会 发 现 


index.html， 把 应 用 的 HTML 代 码 放 在 这 里 ; 在 public/js 目 录 中 将 发 现 mirror 和 web3.js 的 .js 文件 ， 还 会 发 现 一 个 main.js 文 件 ， 
把 应 用 的 前 端 JS 代码 放 在 这 里 。 


6.3.2 Batt 


先 创建 App 后 闹 。 首 先 ， 在 initial 目 录 中 运行 hpm install, Haim ERAAN. 
下 面 是 运行 快捷 服务 并 用 于 index.htm | 文件 和 静态 文件 的 完整 后 端 代码 : 


var express = require("express"); 
var app = express(); 


app.use(express.static("public")); 
app.get("/", function(req, res) { 
res.sendFile(__dirname + "/public/html/index.html"); 


站 


app.listen(8080); 


程序 代码 无 须 解释 说 明 。 继 续 创建 后 端 操作 。 应 用 上 会 有 Compile 和 Deploy 两 个 按钮 。 用 户 单 击 Compile 按 钮 ， 就 编译 合 
£j; 单 击 Deploy 按 钮 ， 就 部 署 合约 。 


我 们 将 在 后 端 编译 和 部 署 合 约 。 尽 省 这 可 以 在 前 端 实现 ， 我 们 还 是 在 后 端 进行 操作 ， 因 为 solds 仅 对 node.js 可 用 (尽管 它 使 


用 的 JavaScript-based 编 译 器 在 前 端 工 作 ) . 


o 为 了 学 习 如 何在 前 端 进行 编译 ， 最 好 了 解 一 下 solcjs 源 代码 ， 以 从 中 知悉 JavaSctipt-based 编 译 器 显示 的 API 的 一 些 情 
Us 


用 户 单 击 Compile 按 钮 时 ， 前 器 将 通过 传达 合约 源 代码 向 /compile 路 径 友 出 GET 请 求 。 如 下 是 该 路 径 的 代码 : 
var solc = require("solc"); 


app.get("/compile", function (req, res) { 


var output = solc.compile(regq.query.code, 1); 
res.send(output); 
}) 


Ei; E Asolcjs, Aleve xX/compileigiz, ERRERA HP EIE NIoptimizerff) s F'iss& SH JURT Vad. HARRI 
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用 户 单 击 Deploy 按 钮 了 时， 前 端 通过 传送 合约 源 代码 和 来 自 该 地 址 的 constructor 实 参 和 私 钥 向 /compile 路 径 发 出 GET 请 求 。 
当 用 户 单 击 这 个 按钮 时， 合约 就 被 部 署 了 ， 交 易 哈 希 将 被 返回 给 用 户 。 相 关 代 码 如 下 : 


程序 代码 的 执行 过 程 如 下 : 


var Web3 = require("web3"); 


var BigNumber = require("bignumber.]js"); 

var ethereumjsUtil = require("ethereumjs-util"); 
var ethereumjsTx = require("ethereumjs-tx"); 

var web3 - new Web3(new 


Web3.providers.HttpProvider ("http://localhost:8545")); 


function etherSpentInPendingTransactions(address, callback) 
{ 
web3.currentProvider.sendAsync ({ 

method: "txpool_content", 


params? [Ty 
Toe "2.0". 
id: new Date().getTime () 


}, function (error, result) { 
if (result.result.pending) 
í 
if(result.result.pending[address]) 
{ 
var txns = result.result.pending[address]; 
var cost = new BigNumber (0); 


föt ivar txn in txns) 


{ 


cost = cost.add((new BigNumber(parseInt(txns[txn].value))).add((new 


BigNumber (parseInt (txns[txn].gas))).mul (new 
BigNumber (parseInt (txns[txn].gasPrice))))); 
} 
callback(null, web3.fromWei(cost, "ether")); 
} 
else 


{ 
pallbaet(mill, TOT 


} 
} 
else 
{ 
Calibackinull., "T0343 
} 
rj 
} 


function getNonce (address, callback) 

{ 

web3.eth.getTransactionCount (address, function(error, result) { 
var txnsCount = result; 


web3.currentProvider.sendAsync({ 
method: "txpool_content", 


params: Il 
J "Ze 
id: new Date().getTime () 


}, function (error, result) { 
if (result.result.pending) 
{ 
if (result.result.pending[address]) 
{ 
txnsCount = txnsCount + 
Object .keys (result.result.pending[address]).length; 
Callback (null, txnsCount); 
} 
else 
{ 
Callback (nulls txnscount); 
} 
} 
else 
{ 
Gallbacki(inüull. ‘txnsCount) 


}) 
) 


app.get("/deploy", function(req, res) { 
var code = req.query.code; 


var arguments - JSON.parse(req.query.arguments); 


var address = req.query.address; 
var output = solc.compile(code, 1); 
Var contracts = outpüut.cohtrdcts; 


for(var contractName in contracts) 


1 


var abi = JSON.parse(contracts[contractName].interface); 
var byteCode = contracts[contractName].bytecode; 

var contract = web3.eth.contract (abi); 

var data = contract.new.getData.call(null, ...arguments, { 


data: byteCode 
DE 


var gasRequired = web3.eth.estimateGas ({ 
datas: "Ux" + data 


I; 


web3.eth.getBalance(address, function(error, balance) { 
var etherAvailable = web3.fromWei(balance, "ether"); 
etherSpentInPendingTransactions (address, function(error, balance) { 
etherAvailable = etherAvailable.sub (balance) 
if (etherAvailable.gte(web3.fromWei (new 
BigNumber(web3.eth.gasPrice).mul(gasRequired), "ether"))) 
{ 
getNonce(address, function(error, nonce) { 
var rawTx = { 
gasPrice: web3.toHex(web3.eth.gasPrice), 
gasLimit: web3.toHex(gasRequired), 
from: address, 
nonce: web3.toHex(nonce), 
datas "Ox" + data 
}; 


var privateKey = ethereumjsUtil.toBuffer(req.query.key, 'hex'); 
var tx = new ethereumjsTx(rawTx); 
tx.sign(privateKey); 


web3.eth.sendRawTransaction("Ox" + tx.serialize().toString('hex'), 
functaionierr. bash).1 
res.send({result: { 
hash: hash, 
1); 
DE- 
F) 
} 
else 


1 


res.send({error: "Insufficient Balance")); 


break; 
} 
}) 


-EXSFGIBBSBACHSEEERI F : 
1) Web 导 入 web3.js、BigNumberjs、ethereumjs-util 和 ethereumjs-tx 库 ， 然 后 创建 一 个 Web3 实 例 。 


2) 定义 一 个 函数 etherlnSspentPendingTransactions， 设 六 数 用 于 计算 一 个 地 址 的 待定 所 有 交易 化 费 的 全 部 以 太 币 。 由 于 
web3.js 不 提供 与 交易 池 相 关 的 JavaScript API， 因 此 使 用 web3.currentProvider.sendAsync 进 行 原始 JSJON-RPC 调 用 。 
sendAsync 用 于 异步 调用 原始 JJON-RPC。 如 果 想 同步 调用 ， 则 使 用 send 方 法 而 非 sndAsync。 当 计算 一 个 地 址 的 待定 交易 中 
化 费 的 全 部 以 太 币 时 ， 我 们 在 交易 池 而 非 在 待定 区 块 中 寻找 待定 交易 。 人 在 计算 以 太 币 总 数 时 ， 我 们 把 每 个 交易 的 值 和 gas 加 起 
来 ， 因 为 消耗 gas 也 会 从 账户 以 太 币 余额 中 扣除 。 


3) 定义 geNonce 了 水 数 ， 使 用 之 前 讨论 的 技术 检索 一 个 地 址 的 nonce。 它 把 挖 出 的 交易 总 数 和 待定 交易 总 数 简单 相 加 。 


4) 声明 /deploy 问 点 。 首 先 编译 合约 ， 然 后 只 部 署 第 一 个 合约 。 如 果 在 提供 的 源 代码 中 发 现 多 个 合约 ， 平 台 将 只 部 署 第 一 
个 合约 。 之 后 ， 可 以 改进 app， 使 其 部 署 所 有 被 编译 的 合约 ， 而 非 仅仅 第 一 个 。 然 后 使 用 web3.eth.contract 创 建 一 个 合约 对 
RR. 


5) 由 于 不 使 用 Hooked-Web3-Provider 或 者 任何 hack 拦 截 帮 送 交易 并 把 它们 转换 成 sendRawTransaction 调 用 ， 为 了 部 署 
合约 ， 现 在 需要 生成 交易 的 数据 部 分 ， 即 将 合约 字 节 码 和 constructor 实 参合 并 ， 编 译 成 十 六 进 制 的 字符 串 。 合 约 对 象 事实 上 人 允 
许 生 成 交易 数据 。 可 以 调用 冲 函 数 实 参 的 getData 方 法 。 如 果 想 获取 数据 以 部 署 合 约 ， 则 调用 contract.new.getData; 如 果 想 
调用 合约 的 一 个 函数 ， 则 调用 contract.functionName.getData。 在 这 两 种 情况 下 ， 都 要 为 getData 万 法 提供 实 参 。 所 以 为 了 生 
成 交易 数据 ， 只 需要 合约 的 ABI。 为 了 更 深入 地 学 习 逆 数 名 称 、 实 参 如 何 结合 以 及 如 何 被 编码 以 生成 数据 ， 请 访 
问 https://github.com/ethereum/wiki/wiki/Ethereum-Contract-ABIl#examples。 但 是 如 果 有 合约 ABI 或 者 知道 如 何 手动 创 
ABI, MAREAD T. 


6) 使 用 web3.eth.estimateGas 来 计算 部 署 合 约 所 需 的 gas 数 量 。 


7) 检查 地 址 是 否 有 足够 的 以 大 币 支 付 部 署 合 约 所 需 的 gas。 检 索 地 址 余额 ， 减 去 待定 交易 的 花费 ， 然 后 检查 剩 下 的 余额 是 
否 大 于 或 者 等 于 gas 所 需 的 以 太 币 。 


8) 得 到 nonce， 签 名 并 广播 交易 ， 把 交易 哈 希 返回 到 前 端 即 可 。 


6.3.3 OIER 


现在 创建 应 用 前 端 。 前 端 包 含 一 个 编辑 器 (editor) ， 可 供用 户 编写 代码 。 当 用 户 单 击 Compile 按 钮 时 ， 将 动态 地 显示 输入 
框 ， 其 中 每 个 输入 框 代 表 一 个 构 霹 函数 实 参 。 当 用 户 单 击 Deploy 按 钮 时 ，constructor 实 参数 值 融 来 目 这 泽 输入 框 。 用 户 需 要 在 
这 些 输入 框 中 输入 JsSON 字 符 串 。 


0 我 们 将 使 用 代码 镜像 (mirror). 库 在 前 端 整合 编辑 器 。 想 更 多 地 学 习 如 何 使 用 代码 镜像 ， 请 访 


问 http:/ / codemirror.net/ o 
应 用 的 前 端 HTML 代 码 如 下 。 将 这 些 代码 放 入 index.html 文 件 中 : 


«IDOCTYPE html» 
«html lang="en"> 
<head> 
<meta charset="utf-8"> 
<meta name="viewport" content="width=device-width, initial-scale=1, 
shrink-to-fit=no"> 
«meta http-equiv="x-ua-compatible" content="i1e=edge"> 
<link rel="stylesheet" href="/css/bootstrap.min.css"> 
<link rel="stylesheet" href="/css/codemirror.css"> 
<style type="text/css"> 
.CodeMirror 
{ 
height: auto; 
} 
</style> 
</head> 
<body> 
<div class="container"> 
<div class="row"> 
«div class="col-md-6"> 
ey 
<textarea id="editor"></textarea> 
cn, 
<span id="errors"></span> 
«button type="button" id="compile" class-"btn btn- 
primary">Compile</button> 
</ Give 
«div class="col-md-6"> 


<Dr> 
<form> 
«div class-"form-group"» 
«label for="address">Address</label> 
<input type="text" class-"form-control" 
id="address" placeholder="Prefixed with Ox"> 
</div> 
<div class="form-group"> 
<label for="key">Private Key</label> 
<input type="text" class-"form-control" 
id="key" placeholder="Prefixed with Ox"> 
</div> 
SmDTo 
«div id="arguments"></div> 
ers 
<button type="button" id-2"deploy" class="btn btn- 
primary">Deploy</button> 
«/ form» 
</div> 
</div> 
</div> 
<script src="/js/codemirror.js"></script> 
<SCript: ‘sec="/ (sy main. JS ></Sscripce 
</body> 
</html> 


在 这 里 ， 可 以 看 到 有 一 个 文本 框 。 该 文本 框 将 包含 用 户 输入 到 代码 镜像 编辑 器 中 的 任何 内 容 。 在 程序 代码 中 的 其 他 东西 无 顷 
解释 。 
完整 的 前 端 JavaScript 代 码 如 下 。 将 这 段 代码 放 入 main.js 文 件 中 : 


var editor = CodeMirror.fromTextArea(document.getElementById("editor"), { 
lineNumbers: true, 


i); 
var argumentsCount = 0; 
document.getElementById("compile").addEventListener("click", function()í 


editor.save(); 
var xhttp = new XMLHttpRequest () ; 


xhttp.onreadystatechange = function() { 
if (this.readyState == 4 && this.status == 200) { 
if (JSON. parse (xhttp.responseText).errors !- undefined) 
{ 
document.getElementById("errors").innerHTML = 


JSON.parse(xhttp.responseText).errors + "<br><br>"; 


} 


else 


{ 


document.getElementById("errors").innerHTML = ""; 


j 


var contracts - JSON.parse(xhttp.responseText).contracts; 


for(var contractName in contracts) 


{ 


var abi = JSON.parse(contracts[contractName].interface); 
document .getElementById ("arguments") .innerHTML = ""; 


forivar count] =. 07 counti < abi.léngth; <counti++) 
{ 
if(abi[counti1].type == "constructor") 


1 


argumentsCount = abi[count1].inputs.length; 


document.getElementById ("arguments") .innerHTML = 
'<label>Arguments</label>'; 


for(var count2 = 0; count2 «€ abi[ocountli].inputs.length; countz++}) 
{ 

var inputElement = document.createElement ("input"); 
inputElement.setAttribute("type", "text"); 
inputElement.setAttribute("class", "form-control"); 
inputElement.setAttribute("placeholder", 

abi[counti].inputs[count2].type); 
inputElement.setAttribute("id", "arguments-" + (count2 + 1)); 


var br = document.createElement ("br"); 


document.getElementById("arguments").appendChild (br); 
document.getElementById("arguments").appendChild(inputElement); 


H 


xhttp.open("GET", "/compile?code-" + 
encodeURIComponent (document.getElementById("editor").value), true); 
xhttp.send(); 

;) 


document.getElementById("deploy").addEventListener("click", function () { 
editor.save(); 


[I$ 


var arguments 


for(var count = 1; count <= argumentsCount; count+t) 


1 
arguments[count - 1] = JSON.parse(document.getElementById("arguments-" + 
count) .value) ; 


j 


var xhttp = new XMLHttpRequest (); 


xhttp.onreadystatechange = function() { 
if (this.readyState -- 4 && this.status -- 200) 
1 
var res = JSON.parse(xhttp.responseText); 


if (res.error) 


{ 


alert ("Error: " + res.error) 

} 

else 

{ 

alert ("Txn Hash: " + res.result.hash); 


} 
i 
else if(this.readyState == 4) 
{ 
alert ("An error occured."); 
} 
}; 


xhttp.open("GET", "/deploy?code=" + 


encodeURIComponent (document.getElementById("editor").value) + "&arguments=" 
+ encodeURIComponent (JSON.stringify(arguments)) + "&address=" + 

document .getElementBylId("address") .value + "&key=" + 
document.getElementById("key").value, true); 


xhttp.send(); 
}) 


上 述 程序 的 执行 过 程 如 下 : 
1) 添加 代码 编辑 器 到 网 页 。 代 码 编辑 器 将 显示 在 textarea 处 ， 而 textarea 将 被 隐藏 。 


2) 处 理 Compile 按 钮 的 单 击 事件 处 理 程序 。 在 其 中 保存 编辑 器 ， 把 编辑 器 的 内 容 复制 到 textarea 处 。 当 按 下 Compile 按 钮 
时 ， 向 /compile 路 径 发 出 请 求 ， 得 到 结果 后 解析 它 并 显示 输入 框 ， 这 样 用 户 可 以 输入 constructor 实 参 。 这 里 只 为 第 一 个 合约 读 
取 constructor 实 参 。 但 是 如 果 合 约 不 止 一 个 ， 融 可 以 改进 UI， 用 于 全 部 合约 构造 轴 数 。 


3) 处 理 Deploy 按 钮 的 单 击 事件 处 理 程序 。 这 里 读 取 constructor 实 参 的 值 ， 解 析 并 把 它们 放 进 一 个 数组 ， 然 后 通过 传送 地 
址 、 密 钥 、 代 码 和 实 参 值 ， 向 /deploy 喘 点 添加 一 个 请 求 。 如 果 这 里 有 错误 ， 则 在 弹出 框 中 显示 ; 人 否则， 在 弹出 框 中 显示 交易 哈 
fb. 
6.3.4 测试 


为 了 测试 App， 在 Initial 目 录 中 运行 app.js 节 点 ， 访 问 localhost: 8080， 将 看 到 如 图 6-1 所 示 的 界面 。 
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Prefixed with Ox 


Deploy 


图 6-1 
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1 pragma solidity 0.4.8; Address 
2 
Prefixed with Ox 
3 contract sample( 
4 i ; | 
5 A Private Key 
6 function sample(int b) Prefixed with 0x 
7 { 
8 a = b; 
9 } Arguments 
m int256 
11 





Deploy 


图 6-2 





输入 一 个 合法 的 地 址 及 其 私 钥 ， 然 后 输入 constructor 实 参 的 数值 ， 并 单 击 Deploy 按 钮 。 如 果 一 切 正 常 ， 将 看 到 带 有 交易 哈 
希 的 报警 框 ， 如 图 6-3 所 示 。 
1 pragma solidity 0.4.8; Address 


2 
3 contract sample( 


Ox8ccOOcfc1c0c2195f29e812726ec9d21 c9fa002f 


4 int a; 











3 Private Key 
6 function sample(int b) 0x6e580bca2e258f4365f710bb5f8eac7165387ce72a32084d219ff36fck 
7 { 
8 a = b; 
9 ) Arguments 
10 } 12 
11 localhost:8080 says: 
Txn Hash: 
Oxa7b4baa8ab3530340abc73f1319ac544bca25fbae565e62f 
Deploy a5d991cc86b32040 
| Prevent this page from creating additional dialogs. 
lb N 
图 6-3 
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在 下 一 章 中 ， 我 们 将 通过 创建 一 个 去 中 心 化 的 投注 应 用 来 学 习 Otaclize。 


Ble ”创建 投注 App 


有 了 时， 智能 合约 需要 访问 来 目 其 他 DApp 或 者 万 维 网 的 数据 。 但 是 扩 术 和 共识 方面 的 挑战 ， 使 得 允许 智能 合约 访问 外 面 的 数 
据 异 常 复杂 。 因 此 ， 目 前 以 太 坊 智能 合约 本 身 不 支持 访问 外 面 的 数据 。 但 是 有 一 些 第 三 方 解 决 方案 可 以 让 以 太 坊 智 能 合约 访问 来 
目 其 他 DApp 或 者 万 维 网 的 数据 。 在 本 章 中 ， 我 们 将 学 习 如 何 使 用 Oraclize 从 以 太 坊 智能 合约 友 出 HTTP 请 求 ， 以 访问 来 自 万维网 
的 数据 。 我 们 还 将 学 习 如 何 访问 仓储 在 IPFs 中 的 文件 、 如 何 使 用 字符 串 库 处 理 字符 串 等 。 我 们 将 通过 创建 一 个 足球 投注 智能 合 


约 和 一 个 客户 站 ， 来 学 习 这 些 内 容 。 
在 本 章 中 ， 我 们 将 讲解 如 下 内 容 : 
- Oraclize 的 工作 原理 。 
: 什么 是 Oraclize 的 多 种 数据 源 ， 它 们 各 自如 何 工 作 。 
在 Oraclize 中 共识 的 工作 原理 。 
C 在 以 太 坊 智能 合约 中 整合 Oraclize。 
: 用 Solidity 库 使 处 理 字 符 串 变 得 容 萄 。 


- 创建 足球 投注 App。 


7.1 Oraclize 概 六 


Oraclize 是 一 种 服务 ， 旨 人 在 使 智能 合约 可 以 访问 来 目 其 他 区 块 链 或 者 万 维 网 的 数据 。 该 服务 目前 在 比特 币 以 及 以 太 坊 测 试 网 
和 主 网 上 可 用 。Oraclize 的 特殊 之 处 是 你 不 需要 信任 它 ， 因 为 它 可 以 为 所 提供 给 智能 合约 的 全 部 数据 做 真实 性 证 明 。 


在 本 章 中 ， 我 们 将 学 习 如 何在 以 太 坊 智能 合约 中 使 用 Oraclize 服 务 从 万 维 网 中 抓 取 数据 。 


7.1.1 ”Oradlize 的 工作 原理 


下 面 来 看 以 太 坊 智能 合约 使 用 Oraclize 从 其 他 区 块 链 和 万 维 网 中 抓 取 数 据 的 过 程 。 


为 了 抓 取 外 部 数据 ， 以 太 坊 智能 合约 需要 发 送 一 个 查询 给 Oraclize， 指 定数 据 源 (表示 从 哪里 抓 取 数据 ) 和 数据 源 的 参数 
(表示 抓 取 什么 数据 ) 。 


各 Oraclize 友 送 一 个 查询 ,意味 着 友 送 一 个 合约 调用 ( 即 内 部 交易 ) 给 以 太 坊 区 块 链 中 出 现 的 Oraclize 合 约 。 


Oraclize 服 务 端 不 断 寻 找 新 传 入 智能 合约 的 查询 。 当 它 友 现 一 个 新 的 查询 时 ， 殊 抓 取 结 果 ， 并 调用 合约 的 _callback 方 法 将 
结果 返回 。 


7.1.2 OMR 


Oraclize 人 允许 智能 合约 抓 取 数 据 的 源 列表 如 下 : 


: URL。URL 数 据 源 允许 用 户 发 送 HTTP GET 或 者 POST 请 求 ， 即 万 维 网 中 抓 取 数 据 。 


Jo 


.WolftamAlpha。\WolframAlpha 数 据 源 允许 用 户 向 WolftamAlpha 知 识 引 擎 提交 查询 ， 并 得 到 答案 。 


blockchain。blockchain 数 据 源 允许 用 户 访问 其 他 区 块 链 的 数据 。 可 以 提交 给 blockchain 数 据 源 的 查询 包括 bitcoin blockchain 


height. litecoinhashrate, bitcoin difficulty, 1NPFRDJuEdyqEn2nmLNaWMfojNksFjbLAS balance 等 。 
“ IPFS。IPFS 数 据 源 允许 用 户 抓 取 IPFS 中 存储 的 文件 。 


: nested。nested 数 据 源 是 一 个 元 数据 源 ， 它 不 提供 访问 其 他 服务 的 权限 。 它 用 来 提供 简单 相 加 逻辑 ， 人 允许 单个 查询 在 任何 
可 用 数据 源 的 基础 上 进行 子 查询 ， 并 产生 一 个 单独 字符 串 作 为 结果 ， 例 如 : 


[WolframAlpha] temperature in ${[IPFS] 
QmP2ZkdsJG7LTw7jBbizTTgY1ZBeen64PqMgCAWz2koJBL]). 


: computation. computation 数 据 源 允 许 特定 应 用 的 可 审计 执行 进入 安全 的 链 下 状 ， 也 就 是 说 ， 它 允许 抓 取 应 用 的 链 下 执行 结 
果 。 在 退出 前 ， 该 应 用 必须 在 最 后 一 行 打印 查询 结果 【在 标准 输出 栏 ) 。 执 行 环境 用 Dockerfile 描 述 ， 创 建 和 运行 该 文件 会 立即 
局 动 主 应 用 。Docketfile 初 始 化 和 应 用 执行 应 当 尽 快 结 束 : 在 AWS t2.micro 实 例 中 最 长 执行 时 间 为 5min。 这 里 考虑 AWS t2.micro 实 
例 ， 因 为 Otaclize 用 它 执 行 该 应 用 。 由 于 数据 源 输入 是 包含 此 类 文件 的 ZIP 文 档 包 的 IPFS 多 个 哈 布 〈Docketfile 和 任何 外 部 文件 依 


赖 ， 且 Docketrfile 必 须 位 于 档案 的 根 目 录 里 ) ， 用 户 应 当 事 前 小 心地 准备 这 个 档案 ， 并 推送 给 IPFS。 


在 写本 书 时 ， 已 经 有 这 些 数据 源 ， 但 是 未 来 还 可 能 有 更 多 数据 源 。 


7.1.3 ”真实 性 证 明 


尽管 Oraclize 是 可 信服 务 ， 用 户 可 能 还 想 检 查 一 下 Oraclize 返 回 的 数据 是 否 真 实 ， 也 就 是 说 ， 检 查 它 在 传输 过 程 中 是 否 受 到 
Oraclize 或 者 其 他 人 的 操控 。 
Oraclize 提 供 的 TLSNotary proof 的 来 源 是 可 选 的 ， 包 括 URL、 区 块 链 以 及 nested 和 computation 数 据 源 。 该 proof 对 


WolframAlpha 和 IPFS 数 据 源 不 可 用 。 目 前 ，Oraclize 仪 支持 TLSNotary proof， 但 是 未 来 可 能 文 持 一 些 其 他 验证 方式 。 目 
By, TLSNotary proof 需 要 手动 验证 ， 但 是 Oraclize 已 经 应 用 于 链 上 proof 验 证 ， 也 惑 是 说 ， 智 能 合约 代码 可 以 自己 验证 


TLSNotary proof[s]BAOraclizeszzlziim, SIERproofZ&sREzedEPXBU, MAMAU. 


这 个 工具 (https://github.com/Oraclize/proof-verification-tool) 是 Oraclize 提 供 的 开源 工具 ， 以 验证 TLSNotary 
proof, 


0 使 用 Oraclize 或 者 验证 proof 不 需要 理解 TLSNotary 的 工作 原理 。 验 证 TLSNotary proof 的 工具 是 开源 的 ， 此 ， 如 果 它 包 


含 任何 恶意 代码 ， 就 会 很 容易 捕获 ， 故 可 以 信任 这 个 工具 。 


下 面 概括 一 下 TLSNotary 的 工作 原理 。 为 了 理解 TLSNotary 的 工作 原理 ， 首 先 需 要 理解 TLS 的 工作 原理 。TLS 协 议 提 供 一 个 让 
客户 端 和 服务 端 创建 加 密 session 的 方式 ， 这 样 其 他 任何 人 都 不 能 读 取 或 操纵 客户 端 和 服务 端 之 间 的 传输 内 容 。 服 务 端 首先 友 送 
WEB (证 书 由 受信 任 的 CA 颁 友 给 域名 所 有 者 ) 给 客户 端 。 证 书包 含 服务 端 公 铀 。 使 用 CA 的 公 钥 解码 证 书 ， 这 样 可 以 验证 该 证 书 
确实 是 由 CA 颁 友 的， 并 得 到 服务 端的 公 钥 。 然 后 ， 客 己 端 生成 一 个 对 称 密 钥 和 一 个 MAC 密 钥 ， 并 使 用 服务 端 公 钥 加 密 它们 ， 友 
送 到 服务 端 。 只 有 拥有 私 钥 的 服务 端 才 能 够 解码 这 条 信息 。 现 在 客户 端 和 服务 端 共 享 同 样 的 对 称 密 钥 和 MAC 密 钥 ， 由 于 其 他 人 
都 不 知道 密 钥 ， 他 们 可 以 开始 彼此 友 送 和 接收 数据 。 在 对 称 密 钥 和 MAC 密 钥 一 起 被 用 于 生成 加 密 信息 的 签名 的 地 方 ， 对 称 密 钥 
用 于 加 密 和 解密 数据 ， 这 样 一 旦 攻击 者 修改 信息 ， 另 一 方丈 可 以 知道 。 


TLSNotary 是 TLS 的 改进 ，Oraclize 用 它 提 供 密码 学 proof， 以 表示 它们 提供 给 智能 合约 的 数据 就 是 数据 源 在 特定 时 间 提 供给 
Oraclize 的 数据 。 事 实 上 ，TLSNotary 协 议 是 开源 拷 术 ， 由 PageSigner 项 目 开 发 使 用 。 


TLSNotary 在 三 方 (服务 端 、 审 计 方 和 被 审计 方 ) 之 间 分 解 对 称 加 密 密 钥 和 MAC 密 钥 。TLSNotary 的 基本 思想 是 被 审计 方 
可 以 向 审计 方 证 明 某 一 个 给 定 结果 是 由 服务 端 在 某 个 给 定时 间 返 回 的 。 


TLSNotary 实 现 上 述 功 能 的 过 程 为 : 审计 方 计算 对 称 密 钥 和 MAC 密 钥 ， 并 且 只 向 被 审计 方 提 供 对称 密 钥 。 被 审计 方 不 需要 
MAC 密 钥 ， 因 为 MAC 签 名 检测 确保 来 自 服务 端的 TLS 数 据 在 传输 过 程 中 不 被 算 改 。 有 了 对 称 密 钥 ， 被 审计 万 可 以 解码 来 自 服务 
映 的 数据 。 因 为 银行 使 用 MAC 密 钥 “ 签 署 ” 所 有 人 信息， 而且 只 有 服务 端 和 审计 方 知 道 MAC 密 钥 ， 因 此 正确 的 MAC 签 名 可 以 被 
当 作 特定 信息 来 目 银行 且 未 经 被 审计 方 和 修改 的 证 明 。 


在 Oraclize 服 务 情况 下 ，Oraclize 是 被 审计 方 ， 而 审计 方 是 一 个 特别 设计 的 开源 Amazon 机 器 图 像 锁定 的 AWs 实 例 。 


它们 提供 的 证 明 数 据 是 一 个 正常 TLSNotaryproof 确 实 已 友 生 的 AWS 实 例 的 已 签名 证 明 。 它 们 还 提供 一 些 涉及 AWS 实 例 中软 
件 运行 的 其 他 证 明 ， 即 目 初 始 化 之 后 它 是 否 被 修改 过 。 


7.1.4 定价 
来 自任 总 以 太 坊 地 址 的 第 一 个 Oraclize 查 询 调 用 都 是 完全 免费 的 。Oraclize 调 用 在 测试 网 中 都 是 免费 的 ! 这 只 适合 在 测试 环 
境 进行 适度 使 用 。 


从 第 二 个 调用 起 ， 要 进行 查询 就 必须 支付 以 太 币 了 。 人 在 发 送 查 询 到 Oraclize ( 即 进 行内 部 交易 调用 ) 时 ， 会 扣除 一 定 费 用 
(从 调用 合约 向 Oraclize 合 约 转 账 以 太 币 ) 。 扣 除 的 以 太 币 数量 取决 于 数据 源 和 证 明 类 型 。 


表 7-1 显 示 了 发 送 查 询 时 扣除 的 以 太 币 数量 。 


表 7-1 发 送 查 询 时 扣除 的 以 太 币 数量 


数据 源 With TLSNotary proof 
blockchain $0.05 
WolframAlpha $0.03 


所 以 如 果 正 在 发 出 HTTP 请 求 ， 而 且 想 要 有 TLSNotary proof， 则 调用 合约 必须 有 价值 $0.05 的 以 太 币 ; 否则 ， 就 返回 异 


al 


7.1.5 ”开始 使 用 Oraclize API 
为 了 让 合约 使 用 Oraclize 服 务 ， 它 需要 继承 usingOraclize 合 约 。 用 户 可 以 在 https://github.com/Oraclize/Ethereum- 
api 找 到 该 合约 。 


usingOraclize 合 约 可 以 代替 Oraclizel 和 OraclizeAddrResolverl 合 约 。 事 实 上 ，usingOraclize 使 得 Oraclizel 和 
OraclizeAddrResolverl 合 约 的 调用 变 得 方便 ， 也 就 是 说 ， 它 提供 了 更 简单 的 API。 也 可 以 直接 调用 Oraclizel 和 
OraclizeAddrResolverl 合 约 。 读 者 可 以 学 习 这 些 合约 的 源 代 码 以 友 现 所 有 可 用 API1， 本 书 中 ， 我 们 只 学 习 最 必需 的 那些 。 


下 面 来 看 设 定 proof 类 型 、 设 定 proof 存 储 位 置 、 进 行 查询 、 获 取 碍 询 费 用 等 的 方法 。 

1. 设 置 证 明 类 型 和 存储 位 置 

无 论 是 否 需 要 来 自 TLSNotary 的 proof， 必 须 在 友 出 查询 之 前 指定 proof 类 型 和 proof 和 存储 位 置 。 
如 果 不 需 要 proof， 就 把 下 面 的 代码 放 入 合约 : 


oraclize setProof (proofType NONE) 


如 果 需 要 proof， 融 把 下 面 的 代码 放 入 合约 : 
oraclize setProof(proofType TLSNotary | proofStorage IPFS) 


Hay, proofStorage 1IPFS 是 唯一 可 用 的 proof 和 存储 位 置 ， 也 瓯 是 襄 ，TLSNotary proof 只 人 存储 在 I|PFS 中 。 


次 只 能 执行 这 些 方法 中 的 任意 一 个 ， 例 如 在 constructor 中 或 者 在 其 他 任何 时 间 (比如 只 需要 某 些 特定 查询 的 proof) 。 


为 了 向 Oraclize 发 送 一 个 查询 ， 需 要 调用 oraclize query 国 数 。 这 个 函数 至 少 需要 两 个 实 参 ， 即 数据 源 和 给 定数 据 源 的 输入 


值 。 数 据 源 实 参 不 区 分 大 小 写 。 


o 


oraclize_queryk šk h9 — Seana Pad T : 


oraclize query("WolframAlpha", "random number between O0 and 100"); 


oraclize query ("URL", 
"https://api.kraken.com/0/public/Ticker?pair=ETHXBT") ; 


oraclize query("IPFS", "QmdEJwJG1T9rzHvBD8i69HHuJaRgGXRKEQCP/BhiBVttZbU") ; 


oraclize query("URL", "https://xyz.io/makePayment", 'í("currency": "USD", 
"amount". | a 


上 述 代 码 的 执行 过 程 如 下 : 


` 如 果 第 一 个 实 参 是 字符 串 ， 就 假定 它 是 数据 源 ， 第 二 个 实 参 就 假定 为 数据 源 的 输入 条 件 。 在 第 一 个 调用 中 ， 数 据 源 是 
WolframAlpha， 我 们 向 它 发 送 的 查询 是 0 和 100 之 间 的 随机 数 。 


. 在 第 二 个 调用 中 , 向 第 二 个 实 参 中 所 示 的 URL 发 出 HTTP GET 请 求 。 
. 在 第 三 个 调用 中 ， 从 IPFS 获 取 QmdEJwJG1T9rzHvBD8i69HHuJaRgXRKEQCP7Bh1BVttZbU 文 件 的 内 容 。 


如 果 数 据 源 之 后 的 两 个 连续 实 参 是 字符 囊 ， 就 假定 它 是 POST 请 求 。 在 最 后 一 个 调用 中 ， 发 出 HTTP POST 请 求 
到 https:/ /xyz.io/makePayment 进 行 支付 。POST 请 求 内 容 是 第 三 个 实 参 中 的 字符 串 。Otaclize 十 分 智能 ， 能 够 检测 基于 字符 串 格 式 
的 content-type 标 头 。 


3. NAB 

如 果 想 让 Oraclize 在 未 来 某 一 预 J 时 间 执 行 查询 ， 残 指定 从 当前 时 | 间 算 起 的 延迟 〈 以 秒 计算 ) 作为 第 一 个 实 参 。 示 例如 下 : 
oraclize_query (60, "WolframAlpha", "random number between 0 and 100"); 
Oraclize 将 在 看 到 上 述 碍 询 60s 之 后 进行 查询 。 所 以 ， 如 果 第 一 个 实 参 是 数字 ， 融 假定 我 们 在 预约 查询 。 

4. 目 定义 gas 


束 像 其 他 任何 交易 一 样 ， 从 Oraclize 到 _callback 消 数 的 交易 要 花费 gas， 即 需要 向 Oraclize 文 付 gas 费 用 。Oraclize_query 
进行 查询 收取 的 以 太 币 还 用 于 在 调用 callback 函 数 时 提供 gas。 调 用 callback 函 数 时 ，Oraclize 默 认 提 供 200000 个 gas。 


这 个 返回 的 gas 费 用 实际 上 受用 户 控制 ， 因 为 用 户 编写 的 callback 等 方法 中 的 代码 可 以 预 估 费用 。 所 以 当 用 Oraclize 进 行 查 
询 时 ， 还 可 以 在 callback 交 易 上 指定 gasLimit 应 当 是 多 少 。 但 需要 注意 的 是 ， 因 为 是 由 Oraclize 友 送 交 易 ， 所 以 没有 人 花费 的 gas 
将 被 返还 给 Oraclize， 而 非 用 户 。 


如 果 200000 gas (默认 值 ， 也 是 最 小 信 ) 不 够 ， 可 以 指定 一 个 更 大 的 gasLimit， 代 码 如 下 : 


oraclize query("WolframAlpha", "random number between 0 and 100", 500000); 


可 以 看 到 ， 如 果 最 后 一 个 实 参 是 数字 ， 残 假定 它 是 自 定 义 的 gas。 在 程序 代码 中 ，Oraclize 将 对 回调 函数 交易 使 用 一 个 
500000 的 gas 上 限 ， 而 非 200000。 因 为 我 们 让 Oraclize 提 供 gas， 所 以 Oraclize 在 调用 oraclize query 时 将 扣除 更 多 以 太 币 ( 根 


据 需 要 多 少 gas) 。 


Q.. 如 果 给 出 的 gasLimit 过 小 ， 且 _callback 方 法 很 长 ， 那 么 可 能 永远 看 不 到 回调 函数 。 还 应 注意 ， 自 定义 的 gas 一 定 要 
大 于 200000。 


5 WARY (callback function) 


BAR ests, OraclizeHEsA QAR e zy, FARM R= SSRN: 


: 对 于 每 个 查询 来 说 ，_callback (bytes32 myid, string result) “. Myid 都 是 一 个 独特 的 ID。 这 个 ID 由 otaclize_quety 方 法 返 


回 。 如 果 人 合约 里 有 多 个 otaclize_quety 调 用 ， 则 将 这 用 于 匹配 该 结果 的 查询 。 
如 果 需 要 TLSNortary 的 proof， 则 结果 为 _callback (bytes32 myid, string result, bytes proof) o 
果 没 有 其 他 方法 ， 回 退 函 数 是 function () o 


下 面 是 _callback 函 数 的 一 个 例子 : 


function calJback (bvtes32 myid, string result) 1 
if (msg.sender !- oraclize cbAddress()) throw; // just to be sure the 
calling address is the Oraclize authorized one 


//now doing something with the result.. 


6. 解 析 助 手 


HTTP 请 求 返 回 的 结果 可 以 是 HTML、JSON、XML 或 二 进 制 等 格式 。 在 Solidity 中 ， 解 析 结 果 是 很 困难 的 ， 且 代价 很 高 。 
Oraclize 提 供 了 解析 助手 ， 在 服务 端 上 处 理解 林 ， 最 终 得 到 的 结果 融 是 用 户 需 要 的 那 部 分 


为 了 让 Oraclize 解 析 结 果 ， 用 户 需 要 把 URL 和 下 面 某 一 个 解析 助手 (Parsing helpers) “打包 ”: 


- xml (http:/ /www.hzcoutse.com/resoutce/readBook?path- /openresources/teach_ebook /uncompressed/17283/OEBPS/Text/..) 
和 json (http:/ /www.hzcoutse.com/resoutce/readBook?path- /opentesources/teach. ebook /uncompressed/17283/O EBPS/Text/..) 助手 


让 Oraclize 只 返回 部 分 SON 或 者 用 XML 解析 的 返回 值 ， 例 如 
` 为 了 得 到 全 部 返回 值 ， 使 用 带 有 api.kraken.com/0/public/Ticker? pait=ETHUSD URL 3: 4 83 URLA JE M. o 


只 想 要 最 终 价 字 段 ， 需 要 使 用 JSON 解 析 调 用 
json (api.kraken.com/0/public/Ticker? pair=ETHUSD) .result.XETHZUSD.c.0。 


: html (http:/ /www.hzcoutse.com/resoutce/readBook? 
path= /openresources/teach. ebook /uncompressed/17283/O EBPS/Text/..) .xpath (http://www.hzcoutse.com/tesoutce/readBook? 
path= /openresources/teach_ebook/uncompressed/17283/OEBPS/Text/..) 助手 用 于 HTML scraping, 4U$ 8 © 281 4E 
xpath (http://www.hzcoutse.com/resource/readBook?path= /opentesources/teach, ebook/uncompressed/17283/O EBPS/Text/..) 3: 


ay XPATH, 4i»: 


` 为 了 抓 取 一 个 特定 tweet 的 文本 ， 使 用 html (https://twitter.com/oraclizeit/status/671316655893561344) .xpath (//* 


[contains (@class, 'tweettext') ]/text () ) ào 


- binary (http:/ /www.hzcoutse.com/resoutce/readBook? 
path= /opentesources/teach. ebook /uncompressed/17283/OEBPS/Text/..) 助手 用 于 获得 诸如 证 书 文件 的 二 进 制 文件 ， 例 如 证 书 文 
件 : 


` 为 了 抓 取 二 进 制 文 件 的 一 部 分 ， 可 以 使 用 slice (offset, length) 。 其 中 第 一 个 参数 是 位 移 ， 第 二 个 参数 是 所 需 的 slice 长 度 
(二 者 都 用 字 节 表示 ) o 


- 示例 : 从 一 个 二 进 制 CRL 中 只 抓 取 开头 300 个 字 节 ， 用 
binary (https:/ /www.sk.ee/ctls/esteid/esteid2015.crl) .slice (0, 300) 。 二 进 制 助 手 必 须 和 slice 选 项 同时 使 用 ， 且 只 接受 二 进 制 文 
件 (不 接受 编译 文件 ) 。 
qp 如 果 服 务 端 不 响应 或 连接 不 上 ， 用 户 将 收 到 一 个 空 回 应 。 可 以 在 http://app.Otaclize.it/homeyV/test_duety 测 试 查询 。 
7. 获 取 查 询 价格 


如 果 在 实际 查询 之 前 想 知 道 查 询 需要 多 少 费用 ， 可 以 使 用 Oraclize.getpPrice () 函数 获取 所 需 的 wei 的 数量 。 第 一 个 实 参 是 
数据 源 ， 第 二 个 实 参 是 可 选项 ， 即 目 定 义 gas。 


一 个 常见 的 使 用 示例 是 ， 当 以 太 币 余额 不 足以 进行 查询 时 ， 通 知客 尸 端 向 合约 添加 以 太 币 。 


7.1.6 JD Exi) 
有 时 ， 用 户 可 能 不 想 暴 露 数据 源 和 /或 数据 源 的 输入 。 例 如 ， 可 能 不 想 暴 露 URL 中 的 AP| (如 果 有 ) 。Oraclize 提 供 了 一 种 在 
智能 合约 中 存储 加 密 碍 询 的 方式 ， 只 有 Oraclize 的 服务 端 才能 解码 。 


Oraclize 提 供 一 个 Python 工具 (https://github.com/Oraclize/encrypted-queries) ， 可 以 用 于 加 密 数据 源 和 /或 数据 源 的 
输入 。 它 生成 一 个 非 确定 性 的 加 密 字符 捉 。 
用 于 加 密 任意 文本 字符 串 的 CUI 命令 如 下 : 
python encrypted queries tools.py -e -p 
044992e69473b7d90ca54d2886c7addd14a61109a£202£1c95e218b0c99eb060c7134c4ae463 


45d00383ac996185762£04997d6£4d6c393c86e4325c469741e64eca9 "YOUR DATASOURCE or 
INPUT" 


其 中 长 长 的 十 六 进 制 字 符 串 是 Oraclize 服 务 端 的 公 钥 。 现 在 用 户 可 以 使 用 前 面 命令 的 输出 代替 数据 产 和 /或 数据 源 的 输入 。 


© 为 了 防止 误 用 加 密 的 查询 ( 即 重播 攻击 ) ， 第 一 个 用 一 个 特定 加 密 查 询 Otaclize 的 合约 成 为 合法 的 所 有 者 。 任 何 重复 
使 用 完全 相同 的 字符 串 的 合约 将 不 被 允许 使 用 它 ， 并 且 将 接收 一 个 空 的 结果 。 因 此 ， 切 记 在 使 用 加 窖 查询 重新 部 署 合约 时 ， 总 是 
要 生成 新 的 加 密 字 符 串 。 


解码 数据 源 


还 有 一 个 称 为 decrypt 的 数据 源 ， 它 用 于 解码 加 密 的 字符 串 。 但 是 这 个 数据 源 不 返回 任何 结果 ， 人 否则 任何 人 融 都 有 能 力 解码 
数据 源 和 数据 源 的 输入 了 。 


尼 是 专门 应 用 于 岂 套 数据 源 的 ， 用 于 对 部 分 查询 进行 加 密 。 这 是 它 唯一 的 使 用 例子 。 


7.1.7 Oraclize Web IDE 


Oraclize 提 供 了 一 个 Web IDE, FAEM UAS., fmERiAOraclize7ji&gWBMFH (S 
Whttp://DApp.Oraclize.it/browser-Solidity/) 。 


如 果 访 问 该 链接 ， 将 注意 到 它 和 Browser Solidity 看 起 来 一 模 一 样 ， 它 实际 上 就 是 Browser Solidity 添 加 的 一 个 额外 功能 。 
为 了 理解 这 个 功能 是 什么 ， 我 们 需要 更 深入 地 理解 Browser Solidity, 


Browser Solidity 不 仅 允 许 用 户 为 合约 编写 、 编 译 和 生成 web3.js 代 码 ， 还 允许 测试 合约 。 到 目前 为 止 ， 为 了 测试 合约 ， 我 
们 设置 一 个 以 太 坊 节点 并 同 它 发 送 交 易 。 但 是 Browser Solidity 可 以 不 用 连接 至 任何 书 点 区 执行 合约 ， 所 有 操作 都 在 内 存 中 进 
行 。 之 所 以 能 够 这 样 ， 是 因为 使 用 了 ethereumjs-vm (EVM 的 一 种 JavaScript 实 现 ) 。 用 户 可 以 使 用 ethereumjs-vm 创 建 自己 
的 EVM 和 运行 字 节 码 ， 也 可 以 通过 提供 目标 URL 来 配置 Browser Solidity， 以 使 用 以 太 坊 节点 。UI 的 信息 量 很 大 ， 用 户 可 以 自己 
尝试 一 遍 。 

Oraclize Web 1DE 的 特殊 之 处 在 于 ， 它 在 in-memory 执 行 环境 下 部 署 Oraclize 合 约 ， 这 样 束 不 需要 连接 到 测试 网 或 者 主 网 


节点 ， 但 是 使 用 Browser Solidity 时 必须 连接 到 测试 网 或 者 主 网 节点 ， 以 测试 Oraclize API, 


Q 如 需 更 多 关于 Otraclize 的 资源 ， 请 访问 https://dev.Otraclize.it/。 


7.2 ”处 理子 符 串 


在 Solidity 中 ， 处 理 字符 串 不 像 在 其 他 高 级 编程 语言 (例如 JavaScript、Python 等 ) 中 那么 简单 。 因 此 ， 许 多 Solidity 开 发 人 
员 使 用 多 种 库 和 合约 ， 以 简化 字符 串 的 处 理 。 


strings 库 是 最 冲 见 的 字符 串 库 。 它 通过 把 字符 串 转换 为 slice (WA) ， 来 进行 添加 、 连 接 、 分 割 、 比 较 等 操作 。slice 是 一 
个 包 侣 字符 串 长 度 和 字符 串 地 址 的 数据 类 型 。 由 于 一 个 slice 只 需要 指定 offset (位 移 ) 和 length (KE) ， 因 此 复制 和 操作 
slices 比 复制 和 操作 它们 所 引用 的 字符 串 要 高 效 得 多 。 


为 了 进一步 降低 gas 成 本 ，slice 上 的 大 部 分 国 数 在 需要 返回 slice 时 通常 会 修改 原 slice， 而 非 分 配 一 个 新 的 slice， 例 
如 ，s.split (".") 要 返回 第 一 个 "" 之 前 的 文本 ， 将 修改 s 以 包含 …" 之 后 的 字符 串 部 分 。 假 设 不 想 修改 原 slice， 就 可 以 使 
用 .copy () 进行 备份 ， 例 如 s.copy () .split (".") 。 注 意 避 免 循 环 使 用 copy， 因 为 Solidity 没 有 内 存 管理 ，copy 将 导致 分 配 很 
多 临时 的 、 之 后 被 舍弃 的 slices。 


复制 字符 捉 数 据 的 浮 数 将 返回 字符 串 ， 而 不 是 slices; 如 果 需 要 ， 这 些 字符 串 可 以 返回 到 slices 用 于 后 续 处 理 。 


下 面 来 看 几 个 使 用 strings 库 处 理 字符 串 的 示例 : 


pragma Solidity ^0.4.07 
import “qithub.com/sArachnids Solidity-stringutiis/strings.sol™: 


Contract COntract 


{ 

ising strings for mi 

function Contract) 

{ 
//convert string to slice 
Var Slice = "yz. abc™.toolice() +? 
//length of string 
var length = slice.len(); 
!füplit a string 
//subslice = xyz 
//slice = abc 
var subslice = slice.split(" ".toSlice()); 
//split & String Into an array 
var s = "www.google.com".toSlice(); 
var delim = ".".toSlice(); 
var parts - new string[] (s.count (delim)); 
ror(urirunt b= 0r ri € parts. length? att) 4 

parts [1]. = s.split (delim). toSEbring(i); 

j 
//Converting a slice back to a string 
var myString = slice.toString(); 
//Concatenating strings 
var finalSlice = subslice.concat(slice); 
//check if two strings are equal 
if(slice.equals (subslice) ) 
{ 
j 

f 

} 


该 程序 代码 无 须 解释 。 


返回 两 个 slices 的 冰 数 共有 两 个 版 本 : nonallocating 版 本 (用 第 二 个 slice 作 实 参 ， 在 适当 位 置 进 行 修改 ) 和 allocating 版 本 
(分 配 并 返回 第 二 个 slice) ， 示 例如 下 : 


var slicel = "abc".toSlice(); 


//moves the string pointer of sliceí to point to the next rune (letter) 
//and returns a slice containing only the first rune 


var slice2 = slicei.nextRune(); 
var slice3 = "abc".toSlice(); 
var slice4 = "",toSlice(); 


//Extracts the first rune from slice3 into slice4, advancing the slice to 
point to the next rune and returns slice4. 
var slice5 = slice3.nextRune(slice4); 


Q 要 更 深入 地 学 习 字 符 串 库 ， 可 以 访问 https://sgithub.com/Atachnid/Solidity-sttingutils 。 


7.3 创建 投注 合约 


在 投注 应 用 中 ， 两 个 人 可 以 就 一 场 足球 比 赛 押 注 ， 一 个 支持 主队 ， 另 一 个 支持 客队 。 他 们 押 注 同样 多 的 钱 ， 赢 家 拿 走 所 有 
钱 。 如 果 比 赛 结果 是 平局 ， 则 各 和 目 拿 回 目 己 的 钱 . 


我 们 将 使 用 FastestLiveScores API 读 取 比 赛 结果 。 它 提供 一 个 免费 接口 ， 人 允许 每 小 时 免费 进行 100 个 请 求 。 首 先 ， 创 建 一 个 
账户 ， 然 后 生成 一 个 API Key。 为 了 创建 一 个 账户 ， 访 问 https://customer.fastestlivescores.Comy/register， 一 旦 建立 了 账 
F, API key 束 在 https://customer.fastestlivescores.com/ 可 视 。 可 以 在 https://docs.crowdscores.comy/ 找 到 API 文 档 。 


在 应 用 中 ， 两 个 人 只 要 打 一 次 赌 ， 就 部 署 一 个 投注 合约 。 该 合约 将 包含 从 FastestLiveScores API 检 索 的 比赛 ID， 每 一 方 需 
要 投入 的 wei 和 双方 地 址 。 双 方 对 合约 投注 后 ， 将 会 看 到 比赛 结果 。 在 比赛 结束 之 前 ， 他 们 将 每 隔 24 小 时 查看 一 次 结果 。 
合约 代码 如 下 : 


pragma Solidity ^0.4.0; 
import "github.com/Oraclize/Ethereum-api/oraclizeAPI.sol"; 
import "githüb.conm/Arachnid/Solidity-strinqutils/sttings.sol"; 


contract Betting is usingOraclize 


{ 


using strings for ws 


string public matchld; 
uint public amount; 
String public urls 


address public homeBet; 
address public awayBet; 


function Betting(string _matchId, uint _amount, string _url) 


{ 


matchTtTad = matchtTas: 


SLA Vo WV Lo Lo WA BLEUE We wd d cie Nh y. 


amount =  amount;j 
url = url; 


oraclize setProof(proofType TLSNotary | 


//1 indicates home team 
//2 indicates away team 
function betOnTeam(uint team) payable 


{ 


if (team == 1) 
{ 
if (homeBet == 0) 
{ 
if (msg.value == amount) 
{ 
homeBet = msg.sender; 
if (homeBet != 0 && awayBet != O0) 
{ 
oraclLize query URL". varias 
} 
} 
else 
{ 
throw; 
} 
} 
else 
{ 
throw; 


} 

else if (team == 2) 

{ 
if (awayBet == 0) 
{ 


if(msg.value == amount) 


awayBet = msg.sender; 


if (homeBet !- 0 && awayBet != 0) 
{ 


Oraclize query ("URL", url); 


proofStorage. IPF5); 


throw; 
} 
} 
else 
{ 
throw; 


function | callback (bytes32 myid, string result, bytes proof) { 


if (msg.sender != oraclize_cbAddress() ) 
{ 
throw; 
} 
else 
{ 
if(result.toSlice().equals("home".toSlice())) 
{ 
homeBet.send(this.balance) ; 
} 
else if (result.toSlice().equals ("away".toSlice() ) ) 
{ 
awayBet.send(this.balance); 
} 
else if (result.toSlice().equals ("draw".toSlice() ) ) 
{ 
homeBet.send(this.balance / 2); 
awayBet.send(this.balance / 2); 
} 
else 
{ 
if (Oraclize.getPrice("URL") < this.balance) 
{ 
oraclize_query (86400, "URL", url); 
} 
} 


该 合约 代码 无 须 解释 说 明 。 现 在 使 用 solc.j$ 或 者 Browser Solidity 编 译 程序 代码 。 不 需要 接 入 strings 库 ， 因 为 其 中 所 有 冰 数 
的 可 视 性 都 被 设 为 internal。 


© J£ Browser Solidity 中 ， 当 指定 从 HTTP URL 中 导入 一 个 库 或 者 合约 时 ， 应 确保 它 被 托管 在 GitHub 上 ， 否 则 就 不 能 抓 
取 。 在 GitHub 文 件 URL 中 ， 应 确保 已 删除 了 协议 和 blob/ {branch-name}。 


7.4 JJiikGtJel e rum 


为 了 方便 帮 现 比赛 ID 以 及 部 署 和 投资 合约 ， 需 要 创建 一 个 UI 客 户 端 。 先 来 创建 一 个 客户 端 ， 它 有 两 个 路 径 ， 即 home 路 径 
(用 于 部 署 合约 和 投注 比赛 ) 和 other 路 径 (用 于 友 现 比赛 列表 ) 。 我 们 将 允许 用 尸 使 用 离线 账户 进行 部 署 和 押 注 ， 这 样 投注 的 
整个 过 程 束 是 去 中 心 化 的 ， 无 法 作 首 。 


在 开始 创建 客 尸 端 之 前 ， 确 保 同 步 测试 网 ， 因 为 Oraclize 只 在 以 太 坊 的 测试 网 / 主 网 上 工作 ， 不 在 私有 了 网 络 上 工作 。 可 以 跳 
转 到 测试 网， 下 载 测试 网 区 块 链 ， 用 --testnet 选 项 蔡 换 --dev 选 项 ， 例 如 : 


Gerh -—restnet -fpe -—fpocorsdemsan 7*7 —=recaddr "0.0.0.0" -—-—t5oport 
Soe 
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在 本 章 的 练习 文件 中 ， 用 户 将 发 现 Final 和 initial 两 个 目录 。Final 包 含 项 目的 最 终 源 代码 ， 而 Initial 包 含 可 用 于 迅速 创建 应 用 
的 空 的 源 代码 文件 和 库 。 
D 为 了 测试 Final 目录 ， 需 要 在 其 中 运行 npm instal, AG, 4% M Find B KP “node app.js 命 令 运行 该 应 用 。 


在 Initial 目 录 中 ， 用 户 将 发 现 一 个 public 目 录 和 两 个 文件 (app.js 和 package.json) 。package.json 包 含 应 用 后 端的 相关 内 
容 ， 把 应 用 后 闯 的 源 代 码 放 在 app.js 里 。 


public 目 录 包 含 与 前 问 相 关 的 文件 。 在 public/css 中 会 发 现 bootstrap.min.css， 它 是 Bootstrap 库 ; 在 public/html 中 会 发 现 
index.html， 把 应 用 的 HTML 代 码 放 在 这 里 ; 在 public/js 目 录 中 会 发 现 web3.js 和 ethereumjs-tx 的 .js 文件 ; 在 public/js 中 还 会 发 
现 一 个 main.js 文 件 ， 把 应 用 的 前 问 JS 代 码 放 在 这 里 。 用 户 还 将 发 现 用 于 加 密 查 询 的 Oraclize Python 工具 。 


7.4.2 ”创建 后 端 


先 来 创建 App 后 端 。 首 先 在 Initial 目 录 中 运行 Npm install， 安 妆 后 端 所 需 的 相关 内 容 。 
如 下 后 端 代 码 用 于 运行 快捷 服务 并 用 于 index.html 文 件 和 静态 文件 ， 并 设置 试图 引 掌 (view engine) : 


var express = require ("express"); 
var app = express(); 


app.set("view engine", "ejs"); 
app.use(express.static("public")); 
app.listen(8080); 


app.get("/", function(req, res) { 
res.sendFile(__dirname + "/public/html/index.html"); 


上 述 程序 代码 无 须 解 释 说 明 。 应 用 将 出 现 一 个 新 的 页 面 ， 显 示 最 近 比 赛 的 列表 ， 包 括 比赛 IiD 和 结果 (如 果 比 赛 结 束 了 ) 。 
相关 代码 如 下 : 


var request = require("request"); 
var moment - require("moment"); 


app.get("/matches", function(req, res) { 


request ("https://api.crowdscores.com/vi/matches?api_key=7b7a988 932de4eaab4e 
dib4dcdcia82a", function(error, response, body) { 


if (lerror && response.statusCode == 200) { 
body = JSON.parse (body) ; 


for (var i= 0; i < body.length; i++) { 

body [i].start = moment.unix(body[i].start / 
LOOQ).ftormati"YYYY MMM DD hb:nmmt:ss"); 

} 


res.render(__dirname + "/public/html/matches.ejs", { 
matches: body 


P); 


} else { 
res.send("An error occured"); 
} 
}) 
;) 


这 里 发 出 API 请 求 以 抓 取 最 近 比 赛 的 列表 ， 然 后 把 结果 传送 给 matches.ejs 文 件 ， 这 样 它 可 以 在 用 己 友 好 的 UI 中 展示 结果 。 
API 结 果 将 比赛 开始 时 间作 为 时 间 戳 ， 因 此 需要 时 间 把 它 转换 为 人 类 可 以 阅读 的 格式 。 我 们 从 后 病 (而 不 是 前 端 ) 友 出 这 个 请 
求 ， 这 样 不 会 把 API key 暴 露 给 用 户 。 


后 端 将 给 前 端 提 供 一 个 API1， 以 供 前 端 在 部 署 合约 之 前 加 密 查 询 。 应 用 不 会 提示 用 户 创建 API key， 因 为 这 是 一 个 不 好 的 UX 
实践 。 应 用 开发 者 控制 API key 不 会 造成 危害 ， 因 为 开发 者 不 能 修改 来 自 API 服 务 端 的 结果 ， 因 此 ， 即 使 应 用 开发 者 知道 了 API 
key， 用 户 仍 将 信任 该 App。 


加 密 的 相关 代码 如 下 : 


var PythonShell = require("python-shell"); 


app.get("/getURL", function(req, res) { 
var matchId = req.query.matchId; 


var options = { 
args? |["=Ee", "<p", 
"044992e9473b7d490ca54d2886c7addd14a61109a£202£1c95e218b0c99eb060c7134c4ae46 
3458g0383ac996185762£04997d6£06c393c86e4325c469741e64eca9", 
"Json(https://api.crowdscores.com/v1/matches/" + matchId + 
"?api key-27b7a988932de4eaab4ed1b4dcdc1a82a).outcome.winner"], 
ScriptPath: | dirname 


; 


PythonShell.run("encrypted queries tools.py", options, function 
(err, results) { 
if (err) 
{ 
res.send("An error occured"); 


j 


else 


{ 


res.send(results[0]); 


我 们 学 习 了 如 何 使 用 这 个 工具 。 为 了 成 功 运行 ， 应 先 在 系统 中 安装 Python。 即 使 已 经 安装 了 Python ， 也 可 能 会 显示 错误 ， 
表示 没有 安装 Python 的 cryptography 和 base58 模 块 。 所 以 如 果 工 具有 提示 ， 就 要 确保 安装 这 些 模块 。 


7.4.3 ”创建 前 端 


现在 开始 创建 App 前 病 。 前 器 将 允许 用 户 看 到 近期 比赛 的 列表 、 部 署 投注 合约 以 及 押 注 一 场 比 赛 ， 并 让 他 们 看 到 关于 投注 合 
约 的 信息 。 


首先 实现 matches.ejs 文 件 ， 它 将 显示 近期 比赛 的 列表 。 相 关 代码 如 下 : 


<!DOCTYPE html» 
«html lang="en"> 
«head» 
«meta charset="utf-8"> 
«meta name-"viewport" content="width=device-width, initial- 
Scale-1, shrink-to-fit-no"» 
«meta http-equiv-2"x-ua-compatible" content="ie=edge"> 
<link rel="stylesheet" href="/css/bootstrap.min.css"> 


</head> 
<body> 
<div class="container"> 
ior 
«div class="row m-t-1"» 
<div Glass-e"col-md-12"5 
<a href="/">Home</a> 
</aiv> 
</div> 
Sor 
«div class="row"> 
«div class-"col-md-12"» 
<table class="table table-inverse"> 
<thead> 
SUL 
«th»Match ID</th> 
<th>Start Time</th> 
<th>Home Team</th> 
<th>Away Team</th> 
<th>Winner</th> 
«tr» 
«/thead» 
<tbody> 
<$% for(var 1=0 i < matches.length; itt) + 
> 
i I Sg 
<td><%= matches[i].dbid %></td> 
<% if (matches[i].start) { %> 
<td><%= matches[i].start %></td> 
<% } else { $» 
<td>Time not finalized</td> 
<% } S> 
«td»«$- matches[i].homeTeam.name 
po«rtd»s 
«td»«$- matches[i].awayTeam.name 
$»«/td» 
«$ if (matches[i].outcome) { %> 
«td»«$- matches[i].outcome.winner 
voc/tud» 


<% } else { $» 
<td>Match not finished</td> 
<% } $5 
«/tr- 
<% } $5 
</tbody> 


«/table» 
cL drv 
«/div» 
he bi > 
</body> 
</html> 


上 述 程序 代码 无 须 解 释 说 明 。 现 在 开始 编写 主页 的 HTML 代 码 。 主 页 将 显示 三 张 表 : 第 一 张 表 部 署 投注 合约 ， 第 二 张 表 对 投 
注 合约 投资 ， 第 三 张 表 显示 已 投注 合约 的 信息 。 


主页 的 HTML 代 码 如 下 。 把 这 段 代 码 放 入 index.htm| 页 面 : 


«IDOCTYPE html» 
«html lang="en"> 
«head» 

«meta charset="utf-8"> 

«meta name="viewport"™ content="width=device-width, initial- 
scale=1, shrink-to-fit-no"» 

«meta http-equiv-2"x-ua-compatible" content="ie=edge"> 

<link rel="stylesheet" href="/css/bootstrap.min.css"> 


</head> 
<body> 
«div class="container"™> 
«bro 


«div class="row m-t-1"-» 
«div cldss-"col-mud-12*"» 
<a href="/matches">Matches</a> 
</div> 
</div> 
<br> 
<div class="row"> 
«div class="col-md-4"> 
<h3>Deploy betting contract</h3> 
<form id="deploy"> 
<div class="form-group"> 
<label>From address: </label> 
<input type="text" class="form-control" 
id-"fromAddress"» 
«/div» 
«div class-"form-group"» 
<label>Private Key: </label> 
<input type="text" class="form-control" 
id-"privateKey"» 
</div> 
“div pclgss-"Iform-group"- 
<label>Match ID: </label> 
<input type="text" class="form-control" 
id-"matchId"» 
</Giv> 
<div class="form-group"> 


<label>Bet Amount (in ether): </label> 
«input type="text" class-"form-control" 
id-"betAmount"» 
«/div» 
«p id="message" style-"word-wrap: break-word"></p> 
<input type="submit" value="Deploy" class="btn 
btn-primary" /» 
</form> 
< 
«div class="col-md-4"> 
<h3>Bet on a contract</h3> 
«form id="bet"> 
«div class="form-group"> 
<label>From address: </label> 
<input type="text" class-"form-control" 
id="fromAddress"> 
</div> 
<div class="form-group"> 


<label>Private Key: </label> 
<input type="text" class-"form-control" 
id="privateKey"> 
Tn 
<div classsS"rormedqroup" 
<label>Contract Address: «/label» 
<input type="text" class-"form-control" 
id="contractAddress"> 
</div> 
<div class="form-group"> 
<label>Team: </label> 
«select class-"form-control" id="team"> 
<option>Home</option> 
<option>Away</option> 
</select> 
«dr 
«p id="message" style-"word-wrap: break-word"></p> 
<input type="submit" value="Bet" class="btn btn- 
primary” /> 
</form> 
edo 
«div class="col-md-4"> 
<h3>Display betting contract</h3> 
fOrm xd-"rfind" 
<div class-"form-group"» 
<label>Contract Address: </label> 
<input type="text" class="form-control" 
d="contractAddress"> 
</div> 
<p id="message"></p> 
<input type="submit" value="Find" class="btn btn- 
primary" /> 
</form> 
</div> 


«T1399 
cgi» 


«script type="text/javascript" srcz"/js/web3.min.js"»«/script» 
<script type="text/javascript" srcz"/js/ethereumjs- 
txz.79"o«/soripp» 
«script type-"text/javascript" src="/js/main.js"></script> 
«/body» 
«/html» 


上 述 程序 代码 无 须 解 释 说 明 。 现 在 开始 编写 Javascript 代 码 ， 以 真正 地 部 署 合 约 、 投 资 合 约 和 显示 合约 信息 。 全 部 相关 代码 
如 下 。 将 这 段 代码 放 入 main.js 文 件 : 


var bettingContractByteCode = "6060604..."; 

var bettingContractABI - 
[("constant":false,"inputs":[i("name":"team","type":"uint256";],"name":"betO 
nleam","outbuts"':[],"payable":trüe, "tvpe";"ftunction"j,|("constant":false,"zin 
puts"s[4"name"i"my1id","tupnoo"iUbytes22"].1"Hame"."result","rfvype":"srtring" Fl. 
"name":"  callback","outputs":[],"payable":false,"type":"function"),í("const 
dnt"sfalse,"inputs":[i"name":"myrd","type"s"bvtes3s2"F,4"name"-"result","tup 
e""string",i"name":"proof","tupe"."bytes"],"name":"- callback”, "outputs" 
 Liy"“pavable”’ :ralse, “Evpe"™ = "function "jy {i"r constant t true, “inpucs" + |), *nane” % 
Purl? "outputs li "names", "types "string”’+ |), "payable" alee. "types "Lunce 
LOH"l,t'constant'":trüue."inpubs"slly "nmame""mabtehlqd","ogtouts"sli"name"7"9." 
type":"string"]],"bayable"sralse,"tuype";"runction"j,|"constant":truüue, "input 
S"$1]s"name"s"amount","outpurcs":[4'name"iw".,"rPvbe" unint2560"r]," "pavabple"sfa 
lse,"type":"function"),í("constant":true,"inputs":[],"name":"homeBet", "outpu 
ts":[("name":"","type":"address"j], "payable":false, "type":"function"j,|"con 
stant":true,"inputs":[],"name":"awayBet","outputs":[í("name":"", "type":"addr 
ess"}], "payable": false, "type": "function"},{"inputs": [{"name":"_matchId", "ty 
pet: "string" yi name":" amount”, "type""ulntz56"l,4i"name"s" url","tvpe":T"st 
ring"!]l,"b5avable":false,"tvype": "constructor" }4> 

var web3 = new Web3 (new 


Web3.providers.HttpProvider("http://localhost:8545")); 


function getAJAXObject () 
{ 
var request; 
if (window.XMLHttpRequest) { 
request = new XMLHttpRequest (); 
} else if (window.ActiveXObject) { 
cry 4 
request = 
} catch (e) { 
try 1 
request = new ActiveXObject ("Microsoft.XMLHTTP") ; 
} catch (e) {} 


new ActiveXObject ("Msxml12.XMLHTTP"); 


return request; 


document.getElementById("deploy").addEventListener("submit", function (e) { 
e.preventDefault(); 


var fromAddress = document.querySelector("#deploy #fromAddress") .value; 
var privateKey = document.querySelector("#deploy #privateKey") .value; 
var matchId = document.querySelector("#deploy #matchId") .value; 

var betAmount = document.querySelector("#deploy #betAmount") .value; 

var url = "/getURL?matchId=" + matchId; 

var request = getAJAXObject (); 


request.open("GET", url); 


request.onreadystatechange = function() { 
if (request.readyState == 4) { 
if (request.status == 200) { 
if (request.responseText != "An error occured") 
{ 
var queryURL = request.responselext; 


var contract = web3.eth.contract (bettingContractABI); 
var data = contract.new.getData (matchId, 
web3.toWei(betAmount, "ether"), queryURL, { 
data: bettingContractByteCode 
} ) 7 


var gasRequired = web3.eth.estimateGas(( data: "Ox" + data 


i); 
web3.eth.getTransactionCount (fromAddress, function(error, nonce) { 


var rawIx = { 
gasPrice: web3.toHex(web3.eth.gasPrice), 
gasLimit: web3.toHex(gasRequired), 
from: fromAddress, 
nonce: web3.toHex (nonce), 
data: "Ox" + data; 
by 


privateKey = EthJS.Util.toBuffer(privateKey, "hex"); 


var tx = new EthJS.Tx(rawTx); 
tx.sign(privateKey); 


web3.eth.sendRawTransaction("Ox" + 


tx.serialize().toString("hex"), function(err, hash) { 
if (!err) 
{document.querySelector("#deploy #message"). 
innerHTML = "Transaction Hash: " + hash + T, 
Iransaction T3 Mining..." + 
var timer = window.setInterval (function () { 


web3 .eth.getTransactionReceipt (hash, function(err, result) { 


-— 


if (result) 
(window.clearInterval(timer); 
document.querySelector("#deploy #message") .innerHTML = 
"Transaction Hash: " + hash + " and contract address is: " + 
result.contractAddress; } 


}) 


}, 10000) 
} 
else 
{document .querySelector ("#deploy #message") .innerHTML = err; 


by 
request.send(null); 
}, false) 


document.getElementById("bet").addEventListener("submit", function (e) { 
e.preventDefault (); 


var fromAddress = document.querySelector ("#bet #fromAddress") .value; 

var privateKey = document.querySelector("#bet #privateKey") .value; 

var contractAddress = document.querySelector ("#bet 
#contractAddress") .value; 


var team = document.querySelector("#bet #team") .value; 


if (team == "Home") 


{ 


team = 1; 


team = 2; 


var contract = 
web3.eth.contract (bettingContractABI) .at (contractAddress) ; 
var amount = contract.amount(); 


var data = contract.betOnTeam.getData (team); 

var gasRequired = contract.betOnTeam.estimateGas(team, { 
from: fromAddress, 
value: amount, 
to: contractAddress 


web3.eth.getTransactionCount(fromAddress, function(error, nonce) { 


var rawTx = { 
gasPrice: web3.toHex(web3.eth.gasPrice), 
gasLimit: web3.toHex(gasRequired), 
from: fromAddress, 
nonce: web3.toHex (nonce), 
data: data, 
to: contractAddress, 
value: web3.toHex (amount) 


bi 
privateKey = EthJS.Util.toBuffer(privateKey, "hex"); 


var tx = new EthJS.Tx(rawTx); 
tx.Sign(privateKey) ; 


web3.eth.sendRawTransaction("Ox" + tx.serialize().toString ("hex"), 
function(err, hash) { 
if(lerr) 
{ 
document.querySelector("#bet #message").innerHTML = "Transaction 
Hash: " + hash; 
} 
else 
{ 
document .querySelector("#bet #message") .innerHTML = err; 
} 
F) 
ij 
), false) 


document.getElementById("find").addEventListener("submit", function (e) { 
e.preventDefault (); 


var contractAddress = document.querySelector ("#find 
#contractAddress") .value; 

var contract = 
web3.eth.contract (bettingContractABI) .at (contractAddress) ; 


var matchId = contract.matchId(); 

var amount = contract.amount(); 

var homeAddress = contract.homeBet (); 

var awayAddress = contract.awayBet (); 

document.querySelector("#find #message") .innerHTML = "Contract balance 
is: " + web3.fromWei (web3.eth.getBalance(contractAddress), "ether") + ", 
Match ID is: " + matchId + ", bet amount is: " + web3.fromWei (amount, 
"ether") + " ETH, " + homeAddress + " has placed bet on home team and " + 
awayAddress + " has placed bet on away team"; 
}, false) 


上 述 代 码 的 执行 过 程 如 下 : 
1) 分 别 在 投注 合约 ByteCode 和 投注 合约 ABI 变 量 中 存储 合约 、 字 节 码 和 ABl。 


2) 创建 一 个 Web3 实 例 ， 它 连接 到 测试 网 书后 。 


3) 定义 getAJAXobject 为 数 (一 个 跨 浏 览 器 兼容 的 国 数 ) ， 它 返回 一 个 AJAX 对 象 。 


4) 同 第 一 张 表 添加 submit 事 件 监 听 器 (event listener) ， 用 于 部 署 合约 。 在 事件 监听 器 的 回调 阔 数 中 ， 通 过 传送 
matchld 向 getURL 终 点 发 出 请 求 ， 获 得 加 密 的 查询 字符 串 。 然 后 生成 数据 部 署 合 约 。 接 着 找 出 gasRequired。 使 用 闵 数 对 象 的 
estimateGas 万 法 计算 所 需 的 gas， 也 可 以 使 用 web3.eth.estimateGas 万 法 (它们 的 实 参 不 同 ) ， 即 在 前 面 的 方法 里 不 需要 传送 
交易 数据 。 记 住 ， 如 果 函 数 调 用 引发 异常 ，estimateGas 将 返回 区 块 gas 上 限 。 随 后 计算 随机 数 。 这 里 使 用 
getTransactionCount 方 法 ， 而 非 我 们 之 前 学 习 的 实际 过 程 。 这 样 做 是 为 了 简化 代码 。 最 后 创建 原始 交易 ， 签 名 并 广播 。 一 旦 挖 


出 交易 ， 束 显示 合约 地 址 ，。 


5) 接 下 来 向 第 二 张 表 添加 submit 事 件 监 听 器 ， 用 于 投注 合约 。 这 里 生成 交易 的 数据 部 分 ， 计 算 所 需 的 gas， 创 建 原始 交 
易 ， 签 名 并 广播 。 在 计算 交易 所 需 的 gas 时 ， 从 账户 地 址 和 value 对 象 属性 传送 合约 地 址 ， 因 为 它 是 函数 调用 ， 而 且 gas 随 着 
value、from 地 址 和 合约 地 址 的 变化 而 变化 。 记 住 ， 在 计算 合约 函数 调用 所 需 的 gas 时 ， 可 以 传送 to、from 和 value 属 性 ， 因 为 
gas 取 决 于 这 些 数 值 。 


6) 最 后 让 第 三 张 表 上 有 submit 事 件 监 听 器 ， 即 显示 已 投注 合约 的 信息 。 


744 Wine Pin 
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使 用 之 前 创建 的 钱包 服务 ， 生 成 三 个 账户。 用 http://faucet.ropsten.be: 3001/ 在 每 个 账户 中 添加 一 个 以 太 币 。 

然后 在 Initial 目 录 中 运行 node app.js， 接 着 访问 http://localhost: 8080/matches， 即 可 看 到 图 7-1 所 示 的 界面 。 


这 里 可 以 复制 任何 比赛 ID。 如 果 想 测试 第 一 场 比赛 ( 即 123945) ， 那 么 访问 http://localhost: 8080， 将 会 看 到 图 7-2 所 示 
的 界面 。 


Match ID 


123945 


123063 


123061 


90293 


126758 


123641 


124173 


123667 


126759 


86683 


68211 


68346 


119466 


76297 


96417 


91822 


67919 


69287 


85271 


119697 


114730 


119692 


120929 


119470 


119076 


Start Time 


2017 Feb 27 04:30:00 


2017 Feb 27 05:00:00 


2017 Feb 27 05:00:00 


2017 Feb 27 08:30:00 


2017 Feb 27 08:30:00 


2017 Feb 27 08:40:00 


2017 Feb 27 09:00:00 


2017 Feb 27 09:00:00 


2017 Feb 27 09:30:00 


2017 Feb 27 10:30:00 


2017 Feb 27 10:30:00 


2017 Feb 27 11:30:00 


2017 Feb 27 11:30:00 


2017 Feb 28 12:45:00 


2017 Feb 28 01:00:00 


2017 Feb 28 01:15:00 


2017 Feb 28 01:15:00 


2017 Feb 28 01:30:00 


2017 Feb 28 01:30:00 


2017 Feb 28 02:00:00 


2017 Feb 28 03:30:00 


2017 Feb 28 04:30:00 


2017 Feb 28 05:00:00 


2017 Feb 28 05:30:00 


2017 Feb 28 06:15:00 


Home Team 


Lokomotiv Tashkent 


Home United 


Hougang United 


Mersin ldmanyurdu 


Ashanti Gold 


Al Fateh 


Al Jazira 


Esteghlal 


Lyngby 


Galatasaray 


Ruch Chorzów 


Viborg 


Melgar 


St Pauli 


Bari 


Fiorentina 


Stade de Reims 


Leicester City 


Arouca 


Deportivo Lara 


Deportes Valdivia 


Zamora 


Curicó Unido 


Cantolao 


Deportes Quindio 


Away Team 

Al Ahli (UAE) 

Courts Young Lions 
Geylang International 
Denizlispor 

Asante Kotoko 
Lekhwiya 

Esteghlal Khuzestan 
Al Taawoun 

Esbjerg 


Besiktas 


Śląsk Wrocław 


AGF Aarhus 

USMP 

Karisruher 

Brescia 

Torino 

Brest 

Liverpool 
Belenenses 
Portuguesa (VEN) 
San Marcos de Arica 
Estudiantes de Mérida 
Deportivo Ñublense 
Alianza Atlético 


Uni6n Magdalena 


Winner 


home 


home 


home 


draw 


away 


draw 


away 


home 


draw 


away 


home 


draw 


home 


home 


home 


draw 


draw 


home 


away 


home 


draw 


home 


draw 


away 


home 





Matches 


Deploy betting contract Bet on a contract 
From address: From address: 
Private Key: Private Key: 
Match ID: Contract Address: 
Bet Amount (in ether): Team: 
Home 


= E 


E 72 


Display betting contract 


Contract Address: 


<> 


现在 部 署 合 约 ， 填 好 第 一 个 表 的 输入 栏 ， 单 击 Deploy 按 钮 ， 如 图 7-3 所 示 。 使 用 第 一 个 账户 部 署 合约 。 


Matches 
Deploy betting contract Bet on a contract 
From address: From address: 


0x7e96b4827056119575c18e127a3aeb901 


Private Key: Private Key: 


0xf120383dfda5b9d9bd1a642f20fd653d2 


Match ID: Contract Address: 
123945 

Bet Amount (in ether): Team: 
1 Home 


Transaction Hash: 
Oxf4e70b22c61cbd5485138b682af90ed2342 
57aae4b0416a7d1d5dfdc7784717d and 
contract address is: 
0x46ed72d44f7cc35ff815a1c12e427dfe90ae 
5a94 


Deploy 





图 7-3 


现在 用 第 二 个 账户 押 注 主队 ， 用 第 三 个 账户 押 注 客队 ， 界 面 如 图 7-4 所 示 。 


<> 


Display betting contract 


Contract Address: 


Matches 


Deploy betting contract 


From address: 


0x7e96b4827056119575c18e127a3aeb90* 


Private Key: 


0xf120383dfda5b9d9bd1a642f20fd653d2 


Match ID: 


123945 


Bet Amount (in ether): 


1 


Transaction Hash: 
Oxf4e70b22c61cbd5485138b682af90ed2342 
57aae4b0416a7d1d5dfdc7784717d and 
contract address is: 
0x46ed72d44f7cc35ff815a1c12e427dfe90ae 
5a94 


Deploy 





Bet on a contract 


From address: 


0x57d2d9af2074ed21a35b2c7c63cab965: 


Private Key: 


Oxb0c9b292d78b5bdef56fe36eed7891d3l 


Contract Address: 


0x46ed72d44f7cc35ff815a1c12e427dfe90 


Team: 


Away 


Transaction Hash: 


Ox2cd5c759916ad7d02729dd1789687fd67e1 


56436b36330628ba620893f8afcb4 


E 7-4 


<> 


Display betting contract 


Contract Address: 


MEEA BEKR, fubFindfztHEUAR aJ D, mee2ISE 7-5 UAB. 


Matches 


Deploy betting contract 


From address: 


0x7e96b4827056119575c18e127a3aeb90* 


Private Key: 


Oxf120383dfdabb9d9bd1a642f20fd653d2 


Match ID: 


123945 


Bet Amount (in ether): 


1 


Transaction Hash: 
Oxf4e70b22c61cbd5485138b682af90ed2342 
57aae4b0416a7d1d5dfdc7784717d and 
contract address is: 
0x46ed72d44f7cc35ff815a1c12e427dfe90ae 
5a94 


Deploy 


Bet on a contract 


From address: 


0x57d2d9af2074ed21a35b2c7c63cab965; 


Private Key: 


Oxb0c9b292d78b5bdef56fe36eed7891d83l 


Contract Address: 


0x46ed72d44f7cc35ff815a1c12e427dfe90 


Team: 


<> 


Away 
Transaction Hash: 
0x2cd5c759916ad7d02729dd1789687fd67e1 
56436b36330628ba620893f8afcb4 


Bet 


图 7-5 


一 旦 挖 出 两 个 交易 ， 再 次 审核 合约 细节 ， 即 可 看 到 与 图 7-6 所 示 类 似 的 界面 。 


Display betting contract 


Contract Address: 


0x46ed72d44f7cc35ff815a1c12e427dfe90 


Contract balance is: 2, Match ID is: 123945, 

bet amount is: 1 ETH, 
0x9743038620ec860365c336fc3afd52ea8900f8a7 
has placed bet on home team and 
0x57d2d9af2074ed21a35b2c7c63cab96524c38bc1 
has placed bet on away team 


i. 


IDETE. 
能 合约 日 趋 允 大 和 复 


Matches 


Deploy betting contract 


From address: 


0x7e96b4827056119575c18e127a3aeb90* 


Private Key: 


Oxf120383dfda5b9d9bd1a642f20fd653d2 


Match ID: 


123945 


Bet Amount (in ether): 


1 


Transaction Hash: 


Oxf4e70b22c61cbd5485138b682af90ed2342 


57aae4b0416a7d1d5dfdc7784717d and 
contract address is: 


Bet on a contract 


From address: 


0x57d2d9af2074ed21a35b2c7c63cab965; 


Private Key: 


Oxb0c9b292d78b5bdef56fe36eed7891d3l 


Contract Address: 


0x46ed72d44f7cc35ff815a1c12e427dfe90 


Team: 


4» 


Away 


Transaction Hash: 


Ox2cd5c759916ad7d02729dd1789687fd67e1 


56436b36330628ba620893f8afcb4 


0x46ed72d44f7cc35ff815a1c12e427dfe90ae E3 


5a94 





Deploy 


可 以 看 到 ， 


[4 士 


AN 一 器 


在 本 章 中 ， 我 们 深入 学 习 了 Oraclize 和 strings 库 ， 并 用 它们 创建 了 
约 和 客户 端 。 为 了 改进 应 用 ， 可 以 向 合 


在 下 一 章 中 ， 我 们 将 通 


第 8 草 创建 企 


到 目前 为 止 ， 我们 使 用 Browser solidity 编 写 和 编译 了 solidity 代 码 ， 还 
这 看 起 来 都 很 好 ， 因 为 我 们 仅仅 编 ; 
， 骨 使 用 当前 的 过 程 


本 章 将 讲解 如 下 内 容 : 


创建 一 种 加 密 货 


图 7-6 


合约 没有 任何 以 太 币 ， 以 太 币 都 极 转 到 赌 主队 赢 的 账户 里 了 。 


约 添加 事件 ， 并 在 客户 端 上 显示 通知 ， 以 进 一 


Display betting contract 


Contract Address: 


0x46ed72d44f7cc35ff815a1c12e427dfe90 


Contract balance is: O, Match ID is: 123945, 

bet amount is: 1 ETH, 
0x9743038620ec860365c336fc3afd52ea8900f8a7 
has placed bet on home team and 
0x57d2d9af2074ed21a35b2c7c63cab96524c38bc1 
has placed bet on away team 


了 一 个 去 中 心 化 的 投注 平台 。 用 户 可 以 继续 根据 需求 自 定义 合 


步 理解 去 中 心 化 投注 应 用 的 基本 架构 。 


币 学 习 如 何 使 用 truffle 创 建 企业 级 以 太 坊 智能 合约 。 


融会 在 编译 和 测试 上 遇 


:etheteumjs-testtpc 节 点 的 概念 及 其 使 用 方法 。 


对 了 一 个 小 合约 ， 其 中 的 引用 〈 对 其 他 合约 的 依赖 ) 很 少 。 
到 问题 。 在 本 草 中 ， 我 们 将 学 习 truffle， 它 通 
使 创建 企 iy altcoin 是 指 除 了 比特 币 之 外 的 所 有 加 密 贷 币 都 叫 作 代 币 。 


业 级 智能 合 4 


用 web3.js 测 试 了 合约 。 我 们 还 可 以 使 用 Solidity 在 线 


随 着 所 要 创建 的 智 
过 创建 altcoin 


事件 主题 (event topic) 的 概念 。 

使 用 truffle-contract 包 处 理 合 约 。 

- 安装 truffle、 探 索 truffle 命 令 行 工 具 和 配置 文件 。 
: 使 用 truffle 编 译 、 部 署 和 测试 Solidity 代 码 。 

. 通过 NPM 和 EthPM 进 行 包 管 理 。 

- 使 用 truffle 操 作 台 和 编写 外 部 脚本 。 


“使 用 truffle 为 DApp 创 建 客户 端 。 


8.1 探索 ethereumjs-testrpc 


ethereumjs-testrpc 是 以 Node.js 为 基础 的 以 太 坊 节点 ， 用 于 测试 和 开 友 。 它 模拟 “全 节点 ”行为 ， 并 使 以 太 坊 应 用 开发 更 
快速 。 它 还 包括 所 有 流行 的 RPC 函 数 和 功能 (例如 事件 ) ， 并 可 以 确定 性 运行 ， 使 开 友 得 更 加 容易 。 


它 用 Javascript 编 写 ， 是 一 个 分 布 式 npm 包 。 人 在 写本 书 时 ，ethereumjs-testrpc 的 最 新 版 本 是 3.0.3， 并 要 求 Node.js 版 本 最 


低 达 到 6.9.1 才 能 正常 运行 。 


qp etheteumjs-testtpc 把 所 有 东西 都 存在 内 存 里 ， 此 ， 节 点 一 旦 重启 ， 将 丢失 以 前 的 状态 。 


8.1.1 安 委 和 使 用 


模仿 以 太 坊 节点 使 用 ethereumjs-testrpc 的 方式 如 下 ， 每 种 方式 都 有 用 例 。 
1.testrpc 命 令 行 应 用 
testrpc 命 令 用 于 模仿 一 个 以 大 坊 节点 。 要 安装 这 个 命令 行 应 用 ， 需 要 在 全 局 安装 ethereumjs-testrpc: 


npm install -g ethereumjs-testrpc 


所 提供 的 多 个 选项 如 下 : 
-4 或 者 --accounts。 用 于 指定 初始 时 生成 的 账户 数量 。 
- -b 或 者 --blocktime。 自动 挖 矿 的 区 块 时 间 (以 秒 计 算 ) 。 默 认为 0， 表 示 没 有 自动 挖 矿 。 


 -d 或 者 --deterministic。 只 要 节点 在 运行 ， 就 生成 10 个 确定 性 地 址 。 也 就 是 说 ， 一 旦 设置 这 个 和 参数， 每 次 都 生成 同一 地 址 


集 。 根 据 预定 义 的 助 记 符 ， 该 选项 还 可 用 于 生成 确定 性 地 址 。 


“ -n 或 者 --secufe。 默 认 人 锁定 可 用 账户 。 如 果 在 不 使 用 --unlocKk 选 项 的 情况 下 使 用 这 个 选项 ， 则 不 会 创建 HD 钱 包 。 


` -m 或 者 --mnemonic。 使 用 一 个 特定 的 HD 钱包 记忆 法 生成 初始 地 址 。 

-或 者 --pott。 监 听 的 端口 号 。 默 认为 8545。 

- -h 或者--hostname。 监 听 的 主机 名 。 黑 认为 节点 的 setvet.listen () RAH. 

: -s 或 者 --seed。 生 成 被 使 用 的 HD 钱包 助 记 符 的 任意 数据 。 

-8 或 者 --gasPrice。 使 用 自 定义 gas 价 格 (默认 为 1) 。 如 果 在 向 节点 发 送 交 易 时 没有 提供 gas 价 格 ， 则 使 用 这 个 gas 价 格 。 


: -] 或 者 --gasLimit。 使 用 自 定 义 gas 上 限 (默认 为 0x47E7C4) 。 如 果 在 向 节点 发 送 交 易 时 没有 提供 gas 上 限 ， 则 使 用 这 个 gas 上 
Ka 


- -{ 或 者 --fotk。 从 另 一 个 目前 在 特定 区 块 运行 的 以 太 坊 节点 分 又 。 输 入 应 该 是 HTTP 位 置 和 其 他 客户 端的 端口 ， 例 


如 http://localhost: 8545。 也 可 以 选择 用 @ 符 号 区 分 区 块 和 分 又 ， 例 如 http://localhost: 8545@1599200. 
i --debug. 输出 用 T 38 TK 的 VM 操作 码 。 


 --account。 该 选项 用 于 导入 账户 。 它 指定 --account=http://www.hzcoutrse.com/resource/readBook? 
path=/openresources/teach_ebook/uncompressed/17283/OEBPS/Text/... 任 意 次 数 ， 传 送 任 意 私 钥 和 相关 余额 以 生成 初始 地 址 。 


Testrpc--account="ptrivatekey，balance"[--account="privatekey，balance"]。 使 用 --account 不 会 创建 HD 钱包 。 


 -u 或 者 --unlock。 它 指定 --unlockhttp://www.hzcoutse.com/resoutce/readBook? 
path=/openresources/teach_ebook/uncompressed/17283/OEBPS/Text/... 任 意 次 数 ， 传 送 地 址 或 者 账户 索引 以 解锁 特定 账户 。 当 与 -- 
secute 一 起 使 用 时 ，--unlock 将 重 写 指定 账户 的 locked 状 态 : testrpc--secure-- 
unlock"0x1234http://www.hzcoutse.com/resoutce/teadBook? 
path= /openresourtces/teach_ebook/uncompressed/17283/OEBPS/Text/..."-- 
unlock"Oxabcdhttp: / /www.hzcourse.com/resoutce/readBook? 
path=/opentesoutces/teach_ebook/uncomptressed/17283/OEBPSVText/."。 还 可 以 指定 一 个 数字 ， 用 索引 解锁 账户 : testrpc--secure- 
u0-u1l1。 该 函数 还 可 以 用 于 模仿 账户 和 打开 用 户 无 法 访问 的 地 址 。 当 用 --fo 全 功能 时 ， 可 以 使 用 testtpc 作 为 区 块 链 上 的 任何 地 址 进 
行 交易 ， 这 对 于 测试 和 动态 分 析 非 常 有 用 。 


 --netwotkId。 用 于 指定 节点 所 在 的 网 络 ID。 


注意 ， 私 铀 有 64 字 符 长 ， 必 须 作 为 以 0x 为 前 缀 的 十 六 位 字符 串 输入 。 余 额 可 以 是 整数 或 者 以 0x 为 前 缀 的 十 六 位 值 ， 用 于 指 
明 该 账户 中 wei 的 数量 。 


2. 使 用 ethereumjs-testrpc 作 为 web3 提 供 方 或 者 HTTP 服 务 器 
可 以 按照 如 下 形式 将 ethereumjs-testrpc 作 为 web3 提 供 方 使 用 : 


Var TestRPC = require("ethereumjs-testrpc"); 
web3.setProvider(TestRPC.provider()); 


可 以 按照 如 下 形式 将 ethereumjs-testrpc 作 为 普通 的 HTTP 服 务 器 使 用 : 


var TestRPC - require("ethereumjs-testrpc"); 
var server = TestRPC.server(); 
server.listen(port, function(err, blockchain) {}); 


provider () 和 server () 都 采用 人 允许 指定 ethereumjs-testrpc 行 为 的 单一 对 象 。 该 参数 是 可 选项 ， 可 用 选项 如 下 : 


accounts。 值 是 一 个 对 象 数组 。 每 个 对 象 应 当 有 一 个 十 六 进 制 的 余额 窗 钥 ， 还 可 以 指明 代表 账户 私 钥 的 sectetKey。 如 果 没 
有 secretKey， 地 址 就 由 给 定 余额 自动 生成 。 如 果 指 明了 secretKey， 就 用 于 决定 账户 地 址 。 


- debug。 输 出 用 于 调试 的 VM 操作 码 。 

` logger。 值 是 一 个 实现 log () BRAN $e. 

- mnemonic。 使 用 一 个 特定 的 HD 钱包 助 记 符 生成 初始 地 址 。 

port。 运 行 时 收听 的 服务 器 端口 。 

- seed。 生 成 HD 钱包 助 记 符 的 任意 数据 。 

- total_accounts。 初 始 时 生成 的 账户 数量 。 

- forko 5 8j vg &3--fork EJ x L48 Elo 

network id, 与 --netwotkId 选 项 相同 。 用 于 指定 该 节点 所 在 的 网 络 ID。 

: time。 第 一 个 区 块 应 当 开 始 的 上 日期。 使 用 该 功能 及 evm_incteaseTime 方 法 测试 依赖 于 时 间 的 代码 。 
“ locked。 指 明 账 户 是 否 上 默认 锁定 。 


- unhlocked_accounts。 一 个 地 址 或 者 地 址 索引 数组 ， 用 于 指明 哪个 账户 应 当 是 解锁 的 。 


8.1.2 ”可 用 RPC 方 法 


ethereumjs-testrpc 可 用 的 RPC 方 法 列表 如 下 : 


eth accounts 

eth blockNumber 

eth call 

eth coinbase 

eth compileSolidity 

eth estimateGas 

eth gasPrice 

eth getBalance 

eth getBlockByNumber 

eth getBlockByHash 

eth getBlockTransactionCountByHash 
eth getBlockTransactionCountByNumber 
eth getCode (only supports block number "latest") 
eth getCompilers 

eth getFilterChanges 

eth getFilterLogs 

eth getLogs 


e eth getStorageAt 

e eth getTransactionByHash 

e eth getTransactionByBlockHashAndIndex 
e eth getTransactionByBlockNumberAndIndex 
e eth_getTransactionCount 

e eth getTransactionReceipt 

e eth hashrate 

e eth mining 

e eth newBlockFilter 

e eth newFilter (includes log/event filters) 
e eth sendTransaction 

e eth sendRawTransaction 

e eth sign 

e eth_syncing 

e eth uninstallFilter 

e net listening 

e net peerCount 

e net version 

e miner start 

e miner stop 

e rpc modules 

e web3 clientVersion 


e web3 sha3 


还 有 一 些 特殊 的 、 非 标准 的 方法 没有 包括 在 最 初 的 RPC 规 汉中 : 
evm_snapshot。snapshot 是 区 块 链 在 当前 区 块 的 状态 。 它 没有 和 参数。 返回 创建 的 snapshot 的 整数 ID。 


evm_frevert。 把 区 块 链 状态 回 撤 到 上 一 个 snapshot。 有 一 个 参数 ， 即 要 还 原 成 的 snapshot ID。 如 果 没 有 传送 snapshot ID， 将 


回 撤 到 最 新 的 snapshot。 返 回 true。 
evm_increaseTime。 增 加 时 间 。 有 一 个 和 参数， 即 增 加 的 时 间 量 (以 s 为 单位 ) 。 返 回 总 的 时 间 调 整 (以 s 为 单位 ) 。 


-evm mines 强制 挖 一 个 区 块 。 没 有 参数 。 无 论 控 矿 是 否 开 始 或 者 停止 都 挖 区 块 。 


8.2 什么 是 事件 主题 


主题 是 用 来 把 事件 泰 引 化 (index) 的 数值 。 没 有 主题 ， 融 不 能 搜索 事件 。 只 要 调用 一 个 事件 ， 融 生成 一 个 黑 认 主题 (被 视 
为 事件 的 第 一 个 主题 ) 。 一 个 事件 最 多 可 以 有 四 个 主题 。 主 题 总 是 按照 相同 顺序 生成 。 可 以 使 用 一 个 或 者 多 个 主题 检索 事件 。 


第 一 个 主题 是 事件 答 名 。 剩 下 三 个 主题 是 系 引 化 的 参数 数值 。 如 果 参 数 是 字符 串 、 字 节 或 者 数组 ， 则 主题 是 它 的 keccak- 
2561875. 


下 面 通 过 一 个 例子 来 帮助 读者 理解 主题 的 仿 义 。 假 设 有 一 个 事件 采用 这 个 形式 : 


event ping(string indexed a, int indexed b, uint256 indexed c, string d, 
int e); 


//invocation of event 
ping ("Random String”, 12, 23, “Random String", 45); 


文 里 共生 成 如 下 四 个 主题 : 


: 0xb62211697c0£56e93£3957c088d492b505b9edd7fb6e7872393b41cdb2020644, iX € X —^M- 3X, CH 


web3.sha3 ("ping (string, int256, uint256, string, int256) ") 生成 。 可 以 看 到 所 有 类 型 都 采用 规范 格式 。 


- 0x30ee7c926ebaf578d95b278d78bc0cde445887b0638870a26dcab901ba21d3£2, iX € € —^MEXÀ, CH 
web3.sha3 ("RandomString") 生成 。 


$ = Fe S vg AM 3 382 3| Æ 0x000000000000000000000000000000000000000000000000000000000000000c fa 
0x0000000000000000000000000000000000000000000000000000000000000017， 即 以 十 六 进 制 表示 的 数值 。 它 们 分 别 用 


EthJS.Util.bufferToHex (EthJS.Util.setLengthLeft (12, 32) ) 4feEthJS.Util.bufferToHex (EthJS.Util.setLengthLeft (23, 32) ) 计 


AR 
F o 


以 太 坊 节操 将 在 内 部 使 用 主题 创建 奈 引 ， 这 样 很 容易 基于 签名 和 索引 化 的 数值 找到 事件 。 


假设 想 获取 前 面 事件 的 事件 调用 ， 其 中 第 一 个 实 参 是 Random String， 第 三 个 实 参 是 23 或 者 78， 则 可 以 用 
web3.eth.getFilter 找 到 它们 : 


var filter = web3.eth.filter({ 

Frome lock: 0, 

toBlock: "latest", 

address: "0x853cdcb4af7a6995808308pb08bb78a74de1ef899", 

toptios 
["0xb62a11697c0£56e93£3957c088d4925505b9edd7fb6e7872a93b41cdb2020644", 


"0x30ee7c926ebaf5784895p2784d878bc0cde445887560638870a26dcab901ba21d3f2", null, 
[EthJS.Util.bufferToHex(EthJS.Util.setLengthLeft (23, 32)), 
EthJS.Util.bufferToHex(EthJS.Util.setLengthLeft(78, 32))]] 
i); 
filter.get(function(error, result) { 
lr i(lerror) 

console.log(result); 


i); 


所 以 这 里 让 节点 从 区 块 链 返回 0x853cdcb4af7a6995808308b08bb78a74de1ef899 合 约 地 址 友 出 的 全 部 事件 ， 其 第 一 个 主 
题 是 0xb62a11697c0f56e93f3957c088d492b505b9edd7fb6e7872a93b41cdb2020644， 第 二 个 主题 是 
0x30ee7c926ebaf578d95b278d78bcOcde445887b0638870a26dcab901ba21d3f2， 第 三 个 主题 是 
0x0000000000000000000000000000000000000000000000000000000000000017 或 者 
0x000000000000000000000000000000000000000000000000000000000000004e, 


Q... GE GERGRALZBAUB SUR. WB. 


8.3 ”开始 使 用 truffle-contract 


在 学 习 truffle 之 前 ， 学 习 truffle-contract 很 重要 ， 因 为 truffle-contract 与 truffle 密 切 相 关 。Truffle 测 试 、truffle 中 与 合约 
交互 的 代码 、 部 署 代码 等 都 是 使 用 truffle-contract 编 写 的 。 


truffle-contract APl 是 一 个 JavaScript 和 Node.js 库 ， 它 使 以 太 坊 智能 合约 的 处 理 变 得 容易 。 到 目前 为 止 ， 我 们 已 经 使 用 了 
web3.js 部 署 和 调用 智能 合约 函数 ， 这 没 问题 ， 但 是 truffle-contract 的 目标 是 更 容易 操作 以 太 坊 智能 合约 。 下 面 是 truffle- 
contract 的 一 些 功能 ， 这 些 功 能 使 truffle-contract 在 处 理智 能 合约 时 优 于 web3.js: 


“ 同步 交易 ， 优 化 了 控制 流 〈 交 易 在 直到 确定 被 挖 出 之 前 都 不 会 停止 ) 。 

` 基于 约定 的 API。 再 没有 “回调 地 狱 。 在 ES6 和 async/await 上 都 可 以 用 。 
“ 默认 交易 数值 ， 例 如 from address 或 者 gas。 

: 返回 每 个 同步 的 日 志 、 交 易 收 据 和 交易 哈 希 。 


在 学 习 truffle-contract 之 前 ， 需 要 知道 它 不 允许 使 用 存储 以 太 坊 节点 之 外 的 账户 签署 交易 ， 也 就 是 说 ， 它 没有 类 似 于 
sendRawTransaction 的 东西 。truffle-contract API 假 设 DApp 中 的 每 个 用 户 各 自 运行 以 大 坊 节 点 ， 且 其 账户 都 存储 在 那个 节点 
中 。 事 实 上 ，DApp 应 该 这 样 运行 ， 因 为 如 果 DApp 的 每 个 客户 端 开 始 让 用 户 创建 和 管理 账户 ， 那 么 用 户 管理 这 么 多 账户 就 成 了 
问题 。 开 发 人 员 为 他 们 创建 的 每 个 客户 端 每 次 都 要 开发 一 个 钱包 manager 也 是 很 痛苦 的 。 现 在 的 问题 是 客户 端 怎 样 才能 知道 用 
户 在 哪里 以 及 用 什么 格式 存储 了 账户 。 所 以 从 概率 角度 出 友 ， 优 选 假设 用 户 将 账户 存储 在 个 人 节点 上 ， 而 且 为 了 管理 账户 ， 它 们 
使 用 以 大 坊 钱 包 应 用 的 东西 。 因 为 以 大 坊 世 点 中 存储 的 账户 由 以 大 坊 世 点 目 身 签名 ， 所 以 束 不 表 需 要 sendRawTransaction 了 。 
每 个 用 户 需要 有 各 目的 节点 ， 而 不 能 分 享 节 点 ， 因 为 解锁 一 个 账户 时 ， 对 使 用 它 的 所 有 人 都 是 开放 的 ， 这 将 使 用 户 能 盗窃 其 他 人 
的 以 太 币 和 用 他 人 的 账户 进行 交易 。 


0 如 果 所 使 用 的 App 要 求 用 户 包含 自己 的 节点 ， 并 在 该 节点 中 管理 账户 ， 那 就 需要 确保 只 有 本 地 应 用 才能 对 该 节点 进行 
JSON-RPC 调 用 ， 而 不 能 让 所 有 人 都 能 调用 。 还 要 确保 用 户 不 会 长 期 解锁 账户 ， 只 要 不 需要 账户 ， 就 应 当 立 即 锁 定 。 


如 果 应 用 要 求 有 创建 和 签署 原始 交易 功能 ， 则 可 以 使 用 truffle-contract 开 发 和 测试 智能 合约 。 在 应 用 中 可 以 与 合约 交互 ， 
就 像 我 们 之 前 做 的 。 


8.31 ”安生 和 导入 truffle-contract 


在 写本 书 时 ，truffle-contract API 的 最 新 版 本 是 1.1.10。 在 导入 truffle-contract 之 前 ， 需 要 先导 入 web3.js， 因 为 需要 创建 
一 个 提供 方 处 理 truffle-contract API， 这 样 truffle-contract 将 内 部 使 用 该 提供 方 进行 JJON-RPC 调 用 。 
{Node.js app 中 安装 truffle-contract， 只 需 在 app 目 录 中 运行 如 下 代码 : 


npm install truffle-contract 


然后 使 用 如 下 代码 导入 : 


var TruffleContract = require("truffle-contract"); 


FEN aes HE AAtruffle-contracth}, &fEhttps://github.com/trufflesuite/truffle-contract& Jg 3Xludist BR HA ag 
23 Ro. 
在 HTML 中 ， 可 以 使 用 如 下 命令 将 它 仔 入 队列 : 


«script type-"text/javascript" src="./dist/truffle- 


Gontrasbt.min.j5"»«/sScEFIDL 


这 样 将 会 有 一 个 可 用 的 TruffleContract 全 局 变量 。 


8.3.2 ”建立 测试 环境 


在 开始 学 习 truffle-contract APl 之 前 ,需要 建立 测试 环境 ， 这 将 有 助 于 我 们 在 学 习 的 同时 测试 代码 。 


a, isíjtestrpc--networkld 10 命 令 ， 即 运行 代表 network ID 10 的 ethereumjs-testrpc 节 点 。 出 于 开发 目的 ， 我 们 随 
机 选取 了 network ID 10， 但 是 用 户 可 以 随意 选择 任何 其 他 网 络 ID。 只 需要 确保 不 是 1， 因 为 主 网 总 是 用 于 真实 的 App， 而 不 是 


用 于 开 友 和 测试 。 
然后 创建 一 个 HTML 文 件 ， 放 入 如 下 代码 : 


<!doctype html» 


«html» 
«body» 
«script type-"text/javascript" src="./web3.min.js"></script> 
<script type-"text/javascript" src="./truffle- 
conbtract.miu.]s"»«!s5orfipt 
«script type-"text/javascript"» 
//place your code here 
</SCript> 
</body> 
</html> 


“Raxkweb3.min.js#itruffle-contract.min,js, truffle-contractill a gscEhttps://github.com/trufflesuite/truffle- 


contract/tree/master/dist 创 建 内 容 。 


8.3.3 truffle-contract API 


现在 来 看 truffle-contract API。 基 本 上 ，truffle-contract 有 两 个 API， 即 合约 抽象 API 和 合约 实例 API。 合 约 抽象 API 代 表 
天 于 合约 (或 者 库 ) 的 多 种 信息 ， 例 如 ABI、 未 接 入 的 字 节 码 、 在 多 个 以 太 坊 网 络 中 的 地 址 (如 果 合约 已 部 署 ) 、 对 于 多 个 以 太 
坊 网 络 它 所 依赖 的 库 地 址 (如 果 已 部 署 ) 和 合约 事件 。 抽 象 API 是 对 所 有 合约 抽象 都 存在 的 一 系列 函数 。 合 约 实例 代表 一 个 特定 
网 络 中 的 已 部 署 合约 。 实 例 API 是 对 合约 实例 可 用 的 API。 它 是 以 Solidity 源 文件 中 的 可 用 函数 为 基础 动态 创建 的 。 特 定 合约 的 合 
约 实例 是 从 代表 同一 合约 的 合约 抽象 中 创建 的 。 


1. 合 约 抽象 API 

合约 抽象 API 是 truffle-contract 与 web3.js 的 不 同 之 处 。 其 特点 如 下 : 

: 它 将 根据 连接 的 网 络 自动 抓 取 默 认 数 值 ， 例 如 库 地 址 、 合 约 地 址 等 ， 因 此 用 户 不 需要 每 次 换 网 络 时 修改 源 代码 。 
` 可 以 选择 只 在 特定 网 络 中 监听 特定 事件 。 

` 把 库 实时 接 入 合约 的 字 节 码 变 得 容易。 在 学 习 了 如 何 使 用 API 之 后 ， 用 户 会 发 现 其 他 优点 。 

在 学 习 如 何 创建 合约 抽象 及 其 方法 之 前 ， 先 写 一 个 样本 合约 (代表 合约 抽象 ) 。 示 例 样本 合约 的 代码 如 下 : 
pragma Solidity ^0.4.0; 


import "github.com/pipermerriam/ethereum-string- 
utils/contracbs/Soringblb,.e9o0l"4 


contract Sample 


{ 
using stringLib for Ty 
event ping(string status); 
function Sample () 
{ 
uint a = 23; 
bytes32 b = a.uintToBytes(); 
bytes32 c = "12"; 
uint d = c.bytesToUInt (); 
ping("Conversion Done"); 
j 
j 


该 合约 使 用 StringLib 库 把 uint 转 换 成 bytes32， 把 bytes32 转 换 成 uint。String-Lib 在 主 网 络 上 的 
0xcca8353a18e7ab7b3d094ee1f9ddc91bdf2ca6a4 地 址 可 用 ,但 是 在 其 他 网 络 上 ， 我 们 需要 部 署 它 以 测试 合约 。 在 进行 下 一 
步 操 作 之 前 ， 使 用 Browser Solidity 编 译 它 ， 因 为 将 需要 ABI 和 字 节 码 。 


现在 创建 一 个 代表 Sample 合 约 的 合约 抽象 和 StringLib 库 。 相 关 代 码 如 下 ， 将 此 段 代 码 放 入 HTML 文 件 中 : 


var provider = new Web3.providers.HttpProvider ("http://localhost:8545"); 
var web3 = new Web3 (provider); 


var SampleContract = TruffleContract ({ 

abi: 
[["rnputs^";[],"payable":false,"tvpe":"constructor"Li,1('"anonytnous"s:false,"Iinpb 
nts":[i"indexed":false,"name":;"status","tyvpe".:"string"])],"name":"ping","tyvp 
e":"event"}], 


unlinked_binary: 
"6060604052341561000c57 fe5b5b6000600060006000601793508373_ StringLib__6394e 


8767390916000604051602001526040518263£ffffffff167c01000000000000000000000000 
000000000000000000000000000000000281526004018082815260200191505060206040518 
083038186803b151561008b57fe5b60325a03Ff4151561009857f£e5b50505060405180519050 
92507£313200000000000000000000000000000000000000000000000000000000000091508 
16000191673. Stringhib. 63981a33a6f90916000604051602001526040518263ffffffffl 
67c010000000000000000000000000000000000000000000000000000000002815260040180 
826000191660001916815260200191505060206040518083038186803b151561014557fe5b6 
0325a03£4151561015257£6555050506040518051905090507£3adb191b3dee3c3ccbe8c657 
275£608902£13e3a020028b12c0d825510439e5660405180806020018281038252600F81526 
02001807£436f£6e76657273696£66e20446£6665000000000000000000000000000000000081 
525060200191505060405180910390a15550505050556033806101da6000396000£30060606 
040525bfe00a165627a7a7230582056ebda5c1e4ba935eb5ad61a271ce8d59c95e0e4bca4aqa2 
0e7£078804801e95c60029", 
networks: { 


i 4 
links: 4 
"StringLib": "0xcca8353a18e7ab7b3d094eeí1f9ddc91bdf2ca6a4" 


by 


events: { 
"Ox3adb191b3dee3c3cche8c657275f608902Ff13e3a020028b12c0d825510439e56": { 


"anonymous": false, 
i Ym E. f 
{ 
"indexed": false, 
"name": "status", 
"type": "atring" 
} 
l, 
"name"s "poing", 
"Lype": "event" 


by 
10: 1 
events: { 
"Ox3adb191b3dee3c3cche8c657/275f608902F13e3a020028b12c0d825510439e56": | 


"anonymous": false, 
TOE | 
{ 
"indexed": false, 
"namer "estatus". 
"type "n 。 "n String” 
} 
] ， 
"name": TSO”, 
"type": "event" 


by 


contract_name: "SampleContract", 


DE 


SampleContract.setProvider (provider); 
SampleContract.detectNetwork(); 


SampleContract.defaults ({ 
from: ‘webs.eth.accounts [0], 
qase "S3OODSUOOT, 
gasPrice: web3.eth.gasPrice, 


}) 


var StringLib = TruffleContract ({ 

abl: 
[("constant":true,"inpüts"s[i"nanme":" 7", *Lype*s"bytess2”" |} i, name” :"bytest ov 
Int",T"ocutputs":[i1"name"i"yet","tvpe":"uint256";];"payable":ralse,"tvbpe":"fuüu 


notion" 4 “Constant.” Erue; INPUTS" = [HA “name” 2 "7". "pope" "ane 256": ) > name":" 
uintToBytes", "outputs": [{"name":"ret", "type":"bytes32"}],"payable":false, "t 
yoe*<"function” } |], 


unlinked_binary: 
"6060604052341561000c57£65b556102178061001c6000396000£30060606040526000357c 
0100000000000000000000000000000000000000000000000000000000900463£ffffffff168 
06381a33a6f1461004657806394e8767d14610076575bfe5b61006060048080356000191690 
60200190919050506100aa565b6040518082815260200191505060405180910390£F35b61008 
c6004808035906020019091905050610140565b604051808260001916600019168152602001 
91505060405180910390f£35b6000600060006000600102846000191614156100C5576100005 
65b600090505b60208110156101355760ff81601F0360080260020a85600190048115156100 
ed57f£e5b0416915060008214156100fF£57610135565b603082108061010E5750603982115b1 
561011857610000565b5b600a8302925060308203830192505b80806001019150506100ca56 
5b8292505b5050919050565b60006000821415610173577E300000000000000000000000000 
0000000000000000000000000000000000000905061016256555560008211156101e61576101 
00816001900481151561018e657£6550460010290507£0100000000000000000000000000000 
0000000000000000000000000000000006030600a848115156101c357£65506010260010281 
179050600a8281151561018957£655p04915061017456555580905055p9190505600a1656272a7 
a72305820d82897c98df4e1a3a71aefc5c486aed29c47c80cfe77e38328ef5fA4cb5efcf2f100 


pa 
networks: { 
I4. 
address: "0xcca8353a18e7ab7b3d094eeí1f9ddc91bdf2caó6a4" 
} 
- 
contract name: "StringLib", 
}) 


StringLib.setProvider (provider) ; 
StringLib.detectNetwork (); 


otraingLib.defaultsii 
from: web3.eth.accounts[0], 
gas: "900000*, 
gasPrice: web3.eth.gasPrice, 


} ) 
上 述 代码 的 执行 过 程 如 下 : 


1) 创建 一 个 provider。truffle-contract 使 用 这 个 provider 与 节点 通信 。 


2) 为 样本 合约 创建 合约 抽象 。 使 用 Truffle-contract 函 数 创建 合约 抽象 。 该 国 数 有 一 个 对 象 ， 其 中 包含 关于 合约 的 多 种 信 
已 。 该 对 象 可 以 被 称 为 artifacts 对 和 象 。abl 和 unlinked _binary 属 性 是 必 选 项 ， 其 他 属性 是 可 选项 。abi 属 性 指向 合约 的 AB1， 而 
unlinked binary 属性 指向 合约 的 未 链接 的 二 进 制 代 码 。 


3) network 属 性 表示 不 同 网 络 中 的 合约 涉及 的 各 种 信息 。 这 里 ， 在 network ID 1 中 ，StringLib 相 关 程 序 被 部 署 在 
0xcca8353a18e7ab7b3d094ee1f9ddc91bdf2ca6a4 地 址 ， 所 以 在 网 络 1 部 署 样本 合约 时 ， 它 会 自动 连接 。 在 networks 对 象 下 
面 还 可 以 设置 address 属 性 ， 表 示 该 合约 已 经 被 部 署 到 这 个 网 络 ， 这 融 是 合约 地 址 。 在 networks 对 象 中 还 有 一 个 events 对 象 ， 
用 于 指明 想 获 取 的 合约 事件 。events 对 象 的 key 是 事件 主题 ，value 是 事件 的 ABI|。 


A) 通过 传送 一 个 新 的 provider 实 例 调用 SampleContract 对 象 的 setProvider 方 法 。 这 是 一 种 传送 provider 的 方式 ， 这 样 
truffle-contract 就 能 与 该 节点 通信 。truffle-contract API 无 法 在 全 局 设置 provider， 反 而 需要 为 每 个 合约 抽象 设置 一 个 
provider。 该 功能 允许 用 户 轻松 接 入 多 个 网 络 并 在 其 中 工作 。 


5) 调用 SampleContract 对 象 的 detectNetwork 方 法 。 这 是 设置 合约 抽象 当前 代表 的 网 络 ID 的 一 种 方式 。 也 惑 是 说 ， 在 对 
合约 抽象 进行 全 部 操作 期 间 ， 使 用 被 映射 到 该 网 络 ID 的 数值 。 该 方法 将 自动 检测 节点 连接 到 了 哪个 网 络 ID， 并 将 自动 设置 这 一 
网 络 ID。 如 果 想 手动 设置 网 络 ID 或 者 实时 修改 ， 可 以 使 用 3ampleContract.setNetwork (network id) 。 如 果 修 改 网 络 ID， 惑 
要 确保 provider 还 指向 同一 个 网 络 的 节点 ， 否 则 truffle-contract 不 能 用 正确 的 链接 、 地 址 和 事件 映射 网 络 ID。 


6) ASampleContract () 生成 的 交易 设置 默认 数值 。 该 方法 用 于 获取 和 设置 (可 选项 ) 交易 默认 值 。 如 果 调 用 时 不 指定 
任何 参数 ， 则 只 返回 一 个 表示 当前 默认 值 的 对 象 ; 如 果 一 个 对 象 被 作为 参数 传送 ， 则 将 设置 新 的 默认 值 。 


7) 为 了 创建 合约 抽象 ， 对 StringLib 库 进行 同样 的 操作 。 
2. 创 建 合约 实例 


合约 实例 代表 在 特定 网 络 中 已 部 署 的 合约 。 要 使 用 合约 抽象 实例 ， 我 们 需要 创建 一 个 合约 实例 。 创 建 合约 实例 的 方法 有 如 下 
3 种 : 


: SampleContract.new ([argl, arg2, http://www.hzcoutse.com/tesoutce/readBook? 
path= /openresources/teach_ebook/uncompressed/17283/OEBPS/Text/...], [tx patams]) 。 该 函数 使 用 合约 要 求 的 任何 constructor 参 
数 ， 并 部 署 一 个 新 的 合约 实例 到 合约 抽象 要 用 到 的 网 络 。 最 后 一 个 实 参 是 可 选 的 ， 可 以 用 它 传送 包括 来 自 地 址 的 交易 、gas 上 限 
和 gas 价 格 在 内 的 交易 参数 。 该 函数 返回 一 个 承诺 ， 在 挖 出 交易 时 ， 该 承诺 归结 为 新 部 署 的 地 址 上 合约 抽 半 的 一 个 新 实例 。 该 方 
法 不 会 对 合约 抽象 代表 的 attifacts 对 象 进行 任何 修改 。 在 使 用 该 方法 前 ， 确 保 它 可 以 为 要 用 到 的 网 络 发 现 字 书 码 所 依赖 的 库 地 
hk. 


: SampleContract.at (address) 。 该 函数 用 于 创建 合约 抽象 的 一 个 新 实例 一 一 代表 传 入 的 地 址 上 的 合约 。 它 返回 一 
个 “thenable ( 则 可 能 ) ”对 象 ( 对 于 反 向 兼容 性 来 说 还 不 是 一 个 实际 的 承诺 ) 。 确 保 代 码 存 在 于 所 要 用 到 的 网 络 中 的 特定 地 址 


之 后 ， 该 苑 数 将 解析 一 个 合约 抽象 实例 。 


- SampleContract.deployed () 。 该 函数 和 at () AMA, 但 地 址 是 从 artifacts 对 象 中 检索 的 。 像 4t () 一 样 ，deployed () 是 合理 
的 。 在 确保 代码 存在 于 所 要 用 到 的 网 络 中 的 特定 地 址 之 后 ， 该 函数 将 解析 一 个 代表 已 部 署 的 合约 的 合约 实例 。 


下 面部 署 合约 并 获取 样本 合约 的 实例 。 在 network ID 10 中 ， 需 要 首先 使 用 new () 部 署 StringLib 库 ， 然 后 把 StringLib 库 
的 已 部 署 地 址 添加 到 StringLib 抽 象 ， 再 把 StringLib 抽 象 接 入 SampleContract 抽 象 ， 最 后 使 用 new () 部 署 样本 合约 以 获取 样本 
合约 的 一 个 实例 。 但 是 在 network ID 1 中 ， 只 需要 部 署 SampleContract 并 获取 其 实例 ， 因 为 已 经 在 那里 部 署 了 StringLib。 全 部 
相关 代码 如 下 : 


上 述 代码 的 执行 过 程 如 下 : 


web3.version.getNetwork(function(err, network id) { 
if (network id == 1) 


{ 


var SampleContract_Instance = null; 
SampleContract.new().then (function (instance) { 
SampleContract.networks[SampleContract.network id] 
["address"] = instance.address; 
SampleContract_Instance = instance; 
}) 
} 
else if(network_id == 10) 
{ 
var StringLib_Instance = null; 
var SampleContract_Instance = null; 
StringLib.new().then(function(instance) { 
StringLib_Instance = instance; 
b) «then (Lunct ion () 4 
StringLib.networks[StringLib.network id] = {}; 


StringLib.networks[StringLib.network id]["address"] = 
StringLib_Instance.address; 


SampleContract.link (StringLib) ; 
)).then(function(result)(í 
return SampleContract.new(); 
}) .then(function(instance) { 
SampleContract.networks[SampleContract.network id] 
["address"] = instance.address;j 
SampleContract Instance - instance; 


} 
I3; 


1) 检测 网 络 ID。 如 果 网 络 ID 是 10， 则 部 署 合 约 和 库 ; 如 果 网 络 ID 是 1， 则 只 部 署 合约 。 
2) 在 network ID 10 中 ， 部 署 StringLib 合 约 并 获取 其 合约 实例 。 


3) 更 新 StringLib 抽 象 ， 这 样 束 知道 了 它 所 代表 的 当前 网 络 的 合约 地 址 。 更 新 抽象 的 界面 类 似 于 直接 更 新 artifacts 对 象 。 如 
果 连 接 到 network ID 1， 则 将 重 写 已 经 设置 好 的 StringLib 地 址 。 


4) 把 已 部 署 的 stringLib 接 入 SampleContract 抽 象 。 接 入 会 更 新 链接 ， 并 把 库 里 的 事件 复制 到 yampleContract 抽 象 的 当前 
网 络 。 库 可 以 被 多 次 接 入 ， 并 将 重 写 它们 之 前 的 链接 。 


5) 部 署 SampleContract 到 当前 网 络 。 
6) 更 新 9ampleContract 抽 儿 ， 以 便 在 当前 网 络 中 仓储 合约 地 址 ， 这 样 以 后 可 以 使 用 deployed () 来 获取 实例 。 


7) 在 network ID 1 中 ， 只 部 署 SampleContract 即 可 。 


8) XA LEN RRA MAHA, MORPHINE TA, DURO, GAARA Les, MERIT A 
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aS, MAAS MartifactswR, MAIVEC Pee ENCARAS AS. MURARE, RAXKHRSC. CANS 
完成 后 ， 用 户 可 以 在 数据 库 或 者 文件 中 存储 artifacts 对 象 并 编写 代码 自动 更 新 (而 非 手动 更 新 ) 。 


3. 合 约 实例 API 
源 Solidity 合 约 不 同 ， 每 个 合约 实例 也 是 不 同 的 ， 且 APl 是 动态 创建 的 。 下 面 是 合约 实例 的 不 同 APl: 


- allEvents。 这 是 一 个 合约 实例 函数 ， 在 当前 网 络 ID 下 ， 当 合约 attifacts 对 象 中 匹配 事件 签名 的 合约 引发 一 个 事件 时 ， 就 激活 
这 个 回调 函数 。 用 户 还 可 以 用 evehthame-specific 函 数 抓 取 特定 事件 ， 而 非 所 有 事件 。 在 前 面 的 合约 中 ， 要 抓 取 ping 事 件 ， 可 以 使 


H| SampleContract_Instance.ping (function (e, r) {t) 。 


send。 该 函数 用 于 向 合约 发 送 以 太 币 。 它 有 两 个 实 参 : 第 一 个 实 参 是 要 转账 的 wei 数 量 ; 第 二 个 实 参 是 可 选项 对 象 ， 该 对 


可 以 使 用 SampleContract.functionName () 或 者 SampleContract.functionName.call () 调用 合约 的 任何 方法 。 前 者 发 送 交 易 ， 
后 者 则 只 调用 EVM 上 的 方法 ， 且 修改 并 不 持续 。 两 种 方法 都 返回 一 个 承诺 。 在 第 一 种 情况 下 ， 承 诺 解 析 交 易 结 果 ， 也 就 是 说 ， 
一 个 对 象 包含 交易 哈 布 、 日 志和 交易 收据 。 在 第 二 种 情况 下 ， 承 诺 解 析 方 法 调用 的 返回 值 。 两 种 方法 都 有 函数 实 参 ， 且 最 后 一 个 


实 参 为 可 选项 ， 它 是 一 个 设置 交易 的 ftom、gas 和 value 等 的 对 象 。 


8.4 truffle 概 述 


truffle 是 一 种 开 上 友 环 境 (提供 编译 、 部 署 、 测 试 和 创建 所 用 的 命令 行 工 具 ) 、 框 染 (提供 多 种 包 ， 使 编写 测试 、 部 署 代码 、 
创建 客户 端 等 变 得 容易 ) 和 asset pipeline (发 布 包 以 及 使 用 其 他 人 发 布 的 包 ) 。 


8.4.1 ”安装 truffle 


truffle 适 用 于 OS X、Linux 和 Windows。truffle 要 求 安装 的 node.js 版 本 高 于 5.0。 在 写本 书 时 ，truffle 的 最 新 稳定 版 本 是 
3.1.2， 我 们 将 使 用 这 个 版 本 。 安 六 truffle 只 需要 运行 如 下 命令 : 


npm install -g truffle 


在 实施 进一步 操作 之 前 ， 确 保 在 network ID 10 上 运行 。 理 由 如 前 所 述 。 


8.42 #W*atttruffle 


首先 需要 为 应 用 创建 目录 。 把 目录 命名 为 altcoin。 人 在 altcoin 目 录 中 ， 运 行 如 下 命令 ， 初 始 化 项 目 : 


truffle init 


初始 化 结束 后 ， 会 得 到 一 个 包 仿 如 下 项 目的 项 目 结构 : 
contracts。 truffle 将 发 现 Solidity 合 约 的 目录 。 
migrations, 包含 合约 部 闭 代 码 的 文件 所 在 的 目录 。 
test。 用 于 检测 智能 合约 的 测试 文件 的 位 置 。 
. truffle.js。 主 要 truffle 配 置 文件 。 
truffle init 默 认 提 供 一 系列 样本 合约 (MetaCoin 和 ConvertLib) 一 一 相当 于 在 以 太 坊 之 上 的 简单 altcoin。 
MetaCoin (元 币 ) 智能 合约 的 源 代码 如 下 (HES) : 
pragma Solidity ^0.4.4; 
import ".rConvertbib.sol"; 


contract MetaCoin { 
mapping (address => uint) balances; 


event Transfer(address indexed _from, address indexed _to, uint256 


| value); 


function MetaCoin() { 
balances[tx.origin] = 10000; 


function sendCoin(address receiver, uint amount) returns(bool 


sufficient) 4 
if (balances[msg.sender] « amount) return false; 


balances[msg.sender] -= amount; 
balances [receiver] += amount; 
Transfer(msg.sender, receiver, amount); 
return true; 


function getBalanceInEth (address addr) returns(uint) { 
return ConvertLib.convert (getBalance (addr),2); 


function getBalance(address addr) returns(uint) { 
return balances[addr|; 


MetaCoin 向 部 署 合约 的 账户 地 址 分 派 10000 个 元 币 。10000 是 存在 的 全 部 比特 币 总 数 。 现 在 该 用 户 可 以 用 sendCoin () && 
数 发 送 元 币 给 任何 人 ， 可 以 随时 用 getBalance () 查询 账户 余额 。 假 设 一 个 元 币 折合 两 个 以 太 币 ， 就 可 以 用 
getBalancelnEth () 得 到 以 太 币 余额 。 


ConvertLib 库 用 于 计算 以 太 币 中 元 币 的 数值 。 为 了 实现 此 目的 ， 该 库 提 供 了 convert () 方法 。 


8.43 编译 合约 


在 truffle 中 编译 合约 将 产生 带 有 abi 和 unlinked_binary 属 性 的 artifact 对 象 。 运 行 如 下 命令 进行 编译 : 


truffle compile 
为 了 避免 不 必要 的 编译 工作 ，truffle 只 编译 上 次 编译 之 后 有 变化 的 合约 。 如 果 想 重 写 这 个 行为 ， 用 --all 选 项 运行 前 面 的 命 


用 户 会 在 build/contracts 目 录 中 友 现 artifacts。 可 以 根据 需要 任意 编辑 这 些 文 件 。 在 运行 compile 和 migrate 命 令 时 ， 这 些 
SCIEBAT. T. 


在 编译 前 ， 需 要 注意 如 下 事项 : 


- truffle 期 望 合约 文件 定义 与 其 文件 名 完全 匹配 的 合约 。 例 如 ， 如 果 有 一 个 文件 叫 作 MyContract.sol， 那 么 合约 文件 须 有 合约 


MyContract{} 或 者 library myContract {+ o 
文件 名 匹配 区 分 大 小 写 ， 即 大 小 写 要 一 致 。 这 意味 着 如 果 文 件 名 没有 大 写 ， 那 么 合约 名 也 不 应 该 大 写 。 


: 可 以 使 用 Solidity 的 导入 命令 声明 合约 相关 内 容 。truffle 将 用 正确 的 顺序 编译 合约 ， 并 在 必要 时 自动 接 入 库 。 必 须 指明 相 关 
内 容 与 当前 Solidity 文 件 之 间 的 关系 ， 开 头 是 “./ ”或 者 “http://www.hzcourse.com/resoutce/readBook? 


path=/openresources/teach_ebook/uncomptressed/17283/OEBPS /Text/../” o 


e truffle 3.1.2 版 本 使 用 编译 器 版 本 0.4.8。truffle 目 前 不 支持 更 换 编 译 器 版 本 ， 所 以 是 固定 的 。 


8.44 配置 文件 


trufflejs 是 用 于 配置 项 目的 JavaScript 文 件 。 该 文件 可 以 执行 为 项 目 创建 配置 所 需 的 任何 代码 。 它 必须 导出 一 个 代表 项 目 配 
置 的 对 象 。 文 件 默 认 内 容 如 下 ; 


module.exports = 1 
networks: 1 
development: { 
host: "loocslhsst". 
port: 8545, 
network id: "*" // Match any network id 


Hr 


该 对 象 可 以 包含 多 种 属性 ， 但 最 基础 的 属性 是 networks。 该 属性 指明 哪个 网 络 对 部 署 可 用 ， 以 及 与 每 个 网 络 交 互 时 的 特定 
交易 参数 (例如 gasPrice、from、gas 等 ) 。 黑 认 gasPrice 是 100000000000，gas 是 4712388，from 是 以 太 坊 客户 端 中 的 第 一 
个 可 用 合约 。 


可 以 随意 指定 网 络 数量 。 继 续 修 改 配 置 文 件 : 


module.exports = 1 
networks: { 
development: { 
noses "loCcalhosb". 
Dort: S345, 
network id: "10" 


rs 
live: { 
hosts “Locainos:, 
DOTE: do45, 
network id: "1" 


} 
; 


上 述 代码 定义 了 development 和 live 两 个 网 络 。 


Q 在 Windows 上 使 用 Prfompt 命 令 时 ， 默 认 配 置 文件 名 可 能 导致 与 可 执行 truffle 的 冲突 。 如 果 遇 到 这 种 情况 ， 推 荐 使 用 


Windows PowerShell 2,4 Git BASH, 为 这 些 shells 没 有 这 种 冲突 。 或 者 可 以 将 配置 文件 重 命名 为 truffle-config.js， 以 避免 冲突 。 


84.5 部署 合约 


即使 是 最 小 的 项 目 ， 也 将 与 至 少 两 个 区 块 链 人 交互 : 一 个 在 开 友 人 员 的 机 器 上 ， 例 如 ethereumjs testrpc; 另 一 个 代表 应 用 最 
终 被 部 署 到 的 网 络 ， 例 如 以 太 坊 主 网 络 或 者 私有 联盟 网 络 ) 。 


因为 合约 抽 和 象 运行 时 目 动 检测 网 络 ， 这 意味 痢 只 需要 部 署 应 用 或 者 前 咒 一 次 。 当 应 用 运行 时 ， 正 在 运行 的 以 六 坊 客户 问 将 决 
定 使 用 哪些 artifacts， 这 将 使 应 用 非常 灵活 。 


如 果 JavaScript 文 件 中 包含 向 以 太 坊 网 络 部 署 合约 的 代码 ， 那 么 此 类 文件 称 为 移植 文件 。 这 些 文件 负责 分 步骤 部 署 任务 ， 它 
们 假定 部 署 需求 将 随时 间 推 进而 改变 一 一 随 着 项 目的 推进 ， 用 户 会 创建 新 的 migrations 脚 本 以 在 区 块 链 上 继续 。 之 前 运行 移植 
的 历史 通过 一 个 特殊 的 Migrations 合 约 记录 在 区 块 链 上 。 如 果 用户 已 经 看 见 合 约 内 容 和 build/contracts 目 录 ， 或 许 就 已 经 注意 
到 了 Migrations 合 约 。 除 了 正常 的 编译 或 发 布 之 外 ， 不 要 修改 这 些 合约 。 


1. 移 植 文件 


在 migrations 目 录 中 ， 文 件 名 的 前 缀 是 数字 ， 例 如 1 initial migration.js 和 2 deploy contracts.js。 前 缀 数字 是 为 了 记录 移 


植 是 否 能 成 功 运 行 。 


Migrations 合 约 在 last_completed_migration 中 存储 一 个 数字 ， 该 数字 与 migrations 文 件 夹 中 最 后 应 用 的 移植 脚本 相 匹 
Ac. Migrations 合 约 总 是 第 一 个 被 部 署 。 编 号 方式 是 x_script_name.js，x 从 1 开始 。 应 用 合约 一 般 从 2 开始 。 


这 样 ，Migrations 合 约 中 就 存储 了 最 后 部 署 的 应 用 脚本 的 序号 ，truffle 将 不 会 再 次 运行 这 些 脚本 。 另 外 ， 应 用 未 来 可 能 需 
要 部 署 修改 过 的 或 新 的 合约 。 为 此 ， 需 要 创建 一 个 新 的 脚本 ， 其 序号 表示 需要 进行 的 步骤 。 待 再次 运行 之 后 ， 它 们 将 不 会 再 次 运 
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{To 
2. 编 与 移植 文件 


在 移植 文件 的 起 始 部 分 ， 用 artifacts.require () 方法 告诉 truffle 想 和 哪个 合约 交互 。 该 方法 类 似 于 节点 的 require 方 法 ,但 
是 在 这 里 ， 它 专门 返回 一 个 可 以 在 部 署 脚 本 的 其 他 部 分 使 用 的 合约 抽象 。 


所 有 移植 必须 通过 module.exports 导 出 函数 。 每 个 移植 导出 的 函数 都 应 当 用 deployer 寺 象 作为 第 一 个 参数 。 该 对 象 从 两 方 


面 帮助 部 署 : 一 是 提供 清晰 的 API 部 署 智 能 合约 ， 二 是 执行 一 些 单调 枯燥 的 任务 ， 例 如 在 artifacts 文 件 中 保存 已 部 署 的 artifacts 
供 今后 使 用 、 接 入 库 等 。deployer 对 象 是 分 阶段 部 署 任务 的 主要 界面 。 


deployer 对 象 的 方法 如 下 。 所 有 方法 都 是 同步 的 : 


- deployer.deploy (contractAbstraction, argshttp://www.hzcourse.com/resoutce/readBook? 
path= /openresoutces/teach_ebook/uncompressed/17283/OEBPS/Text/..., options) 。 部 署 合约 抽象 对 象 指 明 的 特定 合约 ， 采 用 可 
选 constfuctot 实 参 。 这 对 于 单一 合约 很 有 有 用， 这样 你 的 DApp 合 约 中 只 有 一 个 实例 存在 。 这 将 在 部 署 之 后 设置 合约 地 址 〈 即 atftifacts 
文件 地 址 属性 等 同 于 新 部 署 的 地 址 ) ， 且 将 重 写 任何 此 前 存储 的 地 址 。 可 以 选择 性 地 传送 一 个 合约 数组 ， 或 者 多 个 数组 中 的 一 
个 ， 以 加 快 多 个 合约 的 部 署 进 程 。 此 外 ， 最 后 一 个 实 参 是 一 个 可 选 对 象 ， 其 中 包含 单一 密 钥 overwrite。 如 果 overwtite 设 为 false， 
则 deployer 不 部 闭合 约 (如 果 已 经 部 闭 了 一 个 合约 ) 。 该 方法 返回 一 个 承诺 。 


- deployer.link (library, destinations) 。 将 一 个 已 经 部 署 的 库 接 入 一 个 或 者 多 。destinations 实 参 可 以 是 一 个 或 者 多 个 合 
约 抽 象 的 数组 。 如 果 目 的 地 (destination) 里 的 任何 合约 都 不 依赖 于 接 入 的 库 ，deployet 就 会 忽略 该 合约 。 该 方法 返回 一 个 承诺 。 


- deployer.then (function () {}) 。 用 于 运行 任意 部 署 步骤 。 在 移植 中 ， 用 该 方法 调用 特定 合约 函数 ， 添 加 、 修 改 和 重新 组 
织 合约 数据 。 在 回调 函数 中 ， 使 用 合约 抽象 API 部 夏 和 接 入 合约 。 


根据 锌 部 署 网 络 的 情况 ， 可 以 有 条 件 地 分 步骤 部 署 。 这 样 残 要 编写 移植 ， 以 接收 第 二 个 参数 network。 许 多 热门 的 库 已 经 角 
部 署 到 主 网 络 中 ， 因 此 在 使 用 这 些 网 络 时 ， 我 们 不 会 再 次 部 署 库 ， 而 只 是 接 入 它们 。 示 例如 下 : 


module.exports = function(deployer, network) { 
if (network != "live") { 
// Perform a different step otherwise. 
} else { 
// Do something specific to the network named "live". 
} 
} 


在 项 目 中 ， 有 两 个 移植 文件 ， 即 1 initial migration js#12 deploy contracts.js。 不 要 修改 第 一 个 文件 ， 但 可 以 对 第 二 个 文 
件 进 行 修改 。2_ deploy _contracts.js 文 件 的 代码 如 下 : 


var ConvertLib - artifacts.require("./ConvertLib.sol"); 
var MetaCoin = artifacts.require("./MetaCoin.sol"); 


module.exports = function(deployer) { 
deployer.deploy (ConvertLib) ; 
deployer.link(ConvertLib, MetaCoin) ; 


deployer.deploy (MetaCoin); 
ti 


这 里 ， 首 先 为 CovertLib 库 和 MetaCoin 合 约 创建 抽象 。 无 论 使 用 哪个 网 络 ， 先 部 署 ConvertLib 库 ， 然 后 把 库 接 入 MetaCoin 
网 络 ， 最 后 部 署 MetaCoin 网 络 。 
为 了 运行 移植 文件 ， 即 部 署 该 合约 ， 运 行 如 下 命令 : 


truffle migrate --network development 


上 述 代码 表明 truffle 在 开 友 网 络 上 运行 移植 。 如 果 不 提 供 --network 选 项 ， 则 黑 认 使 用 名 为 development 的 网 络 。 

在 运行 前 面 的 命令 之 后 ， 会 友 现 truffle 将 在 artifacts 文 件 中 目 动 更 新 ConvertLib 库 和 MetaCoin 合 约 地 址 ， 并 更 新 链接 。 
下 面 是 可 以 提供 给 migrate 子 命令 的 一 些 其 他 重要 选项 : 

- --teset。 从 最 初 开 始 运行 所 有 移植 〈 而 非 从 上 一 个 移植 结束 之 后 开始 运行 ) 。 


: -fnhumbet。 从 一 个 特定 移植 运行 合约 。 


o 可 以 使 用 truffle hetwotks 命 令 实 时 在 不 同 的 网 络 中 发 现 项 目的 合约 地 址 和 库 。 


8.4.6” 意 元 测试 合约 
单元 测试 是 一 种 应 用 测试 类 型 。 单 元 是 一 个 应 用 的 最 小 可 测试 部 分 ， 在 单元 测试 过 程 中 单元 被 单个 独立 地 进行 测试 。 单 元 测 
试 可 以 手动 操作 ， 但 是 通常 都 用 自动 操作 。 


truffle 有 一 个 单元 测试 框架 ， 默 认 目 动 测试 合约 。 在 运行 测试 文件 时 ， 它 提供 一 个 干净 的 空间 环境 ， 也 束 是 说 ，truffle 在 每 
个 测试 文件 开始 将 重新 运行 所 有 移植 ， 以 保证 有 一 套 全 新 的 合约 用 于 测试 。 


truffle 人 允许 用 两 种 不 同 的 方式 编写 简单 可 管理 的 测试 : 
: 在 JavaSctipt 中 ， 从 客户 端 执行 合约 。 
. 在 Solidity 中 ， 从 其 他 合约 执行 合约 。 
两 种 测试 各 有 优 缺 点 。 我 们 将 学 习 两 种 编写 测试 的 方法 。 


所 有 测试 文件 都 应 置 于 ./test 目 录 中 。truffle 只 运行 扩展 名 为 js、.es、.es6、.jsx 和 .sol 的 测试 文件 。 其 他 类 型 的 文件 都 被 忽 
略 。 


ap 在 运行 自动 测试 时 ，etheteumjs-testtpc 比 其 他 客户 端的 速度 明显 要 快 。 此 外 ，testtpc 有 一 个 特殊 功能 ， 可 以 让 truffle 节 
省 90% 的 测试 运行 时 间 。 推 荐 在 第 规 开 发 和 测试 中 使 用 testtpc; 在 现场 或 者 生产 网 络 中 部 奢 时 ， 再 次 对 go-ethereum 或 者 另 一 个 官 


方 以 太 坊 客户 端 运行 测试 。 
1. 在 JavaScript 中 编写 测试 


truffle 的 JavaScript 测 试 框架 建立 在 Mocha 之 上 。Mocha 是 一 个 用 来 编写 测试 的 JavaScript 框 架 ，chai 是 一 个 
assertion (声明 ) 库 。 


测试 框架 用 于 组 织 和 执行 测试 ， 而 assertion 库 提供 验证 对 错 的 方式 。assertion 库 使 测试 代码 变 得 容易 ， 所 以 不 必 进 行 数 干 
次 if 运 算 。 大 部 分 测试 框架 里 没有 assertion 库 ， 它 们 人 允许 用 户 接 入 想 接 入 的 库 。 


i 在 继续 向 下 学 习 之 前 ， 需 要 学 习 如 何 用 Mocha 和 chai 写 测试 。 学 习 Mocha 请 访问 https://mochajs.otg/ ， 学 习 chai 请 访 
问 http://chaijs.comy o 


测试 应 当 位 于 ./test 目 录 中 ， 并 及 用 .js 扩展 名 。 


合约 抽象 是 使 javaScript 合 约 交 互 成 为 现实 的 基础 。 由 于 truffle 不 能 检测 到 用 户 想 在 测试 中 与 哪个 合约 交互 ， 因 此 需要 明确 
地 询问 这 些 合 约 。 这 惑 需 要 用 到 artifacts.require () 方法 。 所 以 测试 文件 第 一 件 要 做 的 事 就 是 为 想 测 试 的 合约 创建 抽象 。 


然后 ， 应 当 编 写真 实测 试 。 从 结构 上 看 ， 应 该 与 Mocha 的 测试 基本 保持 不 变 。 测 试 文件 应 当 包 含 Mocha 会 认为 是 自动 测试 
的 代码 。 使 truffle 测 试 不 同 于 Mocha 的 是 contract () Ba: 该 国 数 与 describe () 类 似 ， 除 了 它 告 诉 truffle 运 行 所 有 移植 。 
contract () 为数 的 工作 原理 如 下 : 


“ 在 运行 每 个 contract () 函数 之 前 ， 合 约 被 重新 部 署 以 运行 以 太 坊 节 点 ， 所 以 其 中 的 测试 都 是 在 干净 的 合约 状态 下 运行 
的 。 


‘contract () 函数 提供 一 个 以 太 坊 节点 可 用 账户 列表 ， 可 用 于 编写 测试 。 


@ 由 于 ttuffle 在 后 台 使 用 Mocha， 在 不 需要 truffle 功 能 时 ， 还 可 以 使 用 desctibe () 运行 正常 的 Mocha 测 试 。 
下 面 是 truffle 生 成 的 ， 用 于 测试 MetaCoin 合 约 的 默认 测试 代码 。metacoin.js 文 件 中 的 代码 如 下 : 


// Specifically request an abstraction for MetaCoin.sol 
var MetaCoin = artifacts.require("./MetaCoin.sol"); 


contract('MetaCoin', function(accounts) { 
t("should put 10000 MetaCoin in the first account", function() { 
return MetaCoin.deployed().then(function(instance) { 
return instance.getBalance.call(accounts[0]); 
)).then(function(balance) { 


assert.equal(balance.valueOf(), 10000, "10000 wasn't in the first 
account” 73 
i); 
Lig 
it ("should send coin correctly", function() { 
var meta; 


// Get initial balances of first and second account. 
var account one = accounts[0]; 
var account two = accounts[1]; 


var account one starting balance; 
var account two starting balance; 
var account one ending balance; 
var account two ending balance; 


var amount = 10; 


return MetaCoin.deployed().then(function(instance) { 
meta = instance; 
return meta.getBalance.call (account_one) ; 
)).then(function(balance) { 
account one starting balance = balance.toNumber(); 
return meta.getBalance.call(account two); 
)).then(function(balance) { 


account two starting balance = balance.toNumber(); 
return meta.sendCoin(account two, amount, {from: account one]); 
)).then(function() ( 


return meta.getBalance.call (account one); 
)).then(function(balance) { 
account one ending balance = balance.toNumber(); 
return meta.getBalance.call(account two); 
)).then(function(balance) { 
account two ending balance = balance.toNumber(); 


assert.equal(account one ending balance, account, one starting balance 
- amount, "Amount wasn't correctly taken from the sender"); 

assert.equal(account two ending balance, account two starting balance 
* amount, "Amount wasn't correctly sent to the receiver"); 


)); 


在 上 述 程序 代码 中 ， 所 有 合约 的 交互 代码 都 是 使 用 truffle-contract 库 编写 的 。 


最 后 ，truffle 允 许 访问 Mocha 的 配置 ， 所 以 可 以 修改 Mocha 的 行为 。Mocha 的 配置 在 truffle.js 文 件 的 导出 对 象 中 被 放 在 
Mocha 属 性 之 下 ， 例 如 : 


mocha: 4 
useColors: true 


2. 在 Solidity 中 编写 测试 


Solidity 测 试 代码 在 .sol 文 件 中 。 使 用 Solidity 写 测试 之 前 需要 注意 如 下 事项 : 

“Solidity 测 试 不 能 扩展 自任 何 合约 。 这 让 测试 尽 可 能 小 ， 用 户 还 能 完全 控制 自己 编写 的 合约 。 

truffle 提供 一 个 默认 的 assettion 库 ,但 是 可 以 根据 需要 随时 修改 这 个 库 。 

可 以 对 任意 以 太 坊 客户 端 运行 Solidity 测 会。 

为 了 学 习 如 何在 Solidity 中 编写 测试 ， 让 我 们 看 看 truffle 生 成 的 默认 Solidity 测 试 代码 。TestMetacoin.sol 文 件 的 代码 如 下 : 
pragma Solidity ^0.4.2; 

import "truffle/Assert.sol"; 

import "truffle/DeployedAddresses.sol"; 


import "../oó0ntfacbs/Metacoin.sol" 


contract TestMetacoin { 


function testInitialBalanceUsingDeployedContract() { 
MetaCoin meta = MetaCoin (DeployedAddresses.MetaCoin()); 


uint expected = 10000; 


Assert.equal (meta.getBalance (tx.origin), expected, "Owner should have 
10000 MetaCoin initially"); 


j 


function testInitialBalanceWithNewMetaCoin() { 
MetaCoin meta = new MetaCoin(); 


uint expected 100005; 


Assert.equal (meta.getBalance(tx.origin), expected, "Owner should have 
10000 MetaCoin initially"); 


j 


上 述 代码 的 执行 过 程 如 下 : 


- truffle/ Assert.sol E J& BE Assert.equal () 等 Assettion 函 数 。 这 是 默认 的 assettion 库 ， 然 而 只 要 库 与 ttuffle 测 试 运行 者 松散 地 整 


^Y 
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(https: //github.com/ConsenSys/truffle/blob/beta/lib/testing/Assert.sol) o 


| 在 导入 路 径 ttuffle/Assett.sol 中 ，ttuffle 是 包 名 。 


` 已 部 署 合 约 〈 即 作为 migtations 一 部 分 的 部 署 合 约 ) 的 地 址 在 truffle/Deployed-Addresses.sol 库 中 都 可 用 。 这 由 truffle 提 供 ， 且 
在 运行 每 个 测试 程序 组 之 前 重新 编译 并 重新 接 入 。 这 个 库 用 DeployedAddresses.<contract name> () 的 形式 为 所 有 已 部 署 合约 提供 
函数 。 这 将 返回 一 个 地 址 ， 可 用 以 访问 合约 。 


为 了 使 用 已 部 着 合约 ， 必 须 将 合约 代码 导入 测试 。 在 前 面 的 例子 里 ， 注 意 寻 


A "http:/ /www.hzcoutse.com/resource/teadBook? 


path= /openresources/teach_ebook/uncompressed/17283/OEBPS/Text/../conttacts/MetaCoin.sol” 。 该 导入 与 ./test 目 录 中 的 测试 合 


约 有 关 ， 为 了 发 现 MetaCoin 合 约 ， 它 会 超出 测试 目录 。 然 后 使 用 该 合约 把 地 址 投射 给 MetaCoin 类 型 。 
. 所 有 测试 合约 开头 都 是 Test (使 用 大 写 T) 。 这 对 合约 和 测试 助手 以 及 项 目 合 约 ( 即 测试 中 的 合约 ) 进行 了 区 分 ， 让 测试 


者 知道 哪个 合约 代表 测试 版 。 


- 像 测试 合约 名 一 样 ， 所 有 测试 吻 数 开头 都 是 test (使 用 小 写 t) 。 每 个 测试 骂 数 都 被 当 作 单一 交易 按照 出 现在 测试 文件 ( 例 
如 你 的 JavaSctipt 测 试 ) 中 的 顺序 执行 。truffle/ Assert.sol 提 供 的 Assertion 吕 数 触发 事件 ， 测 试 运行 者 评估 以 决定 测试 结果 。 


Assertion $ &i& Te] — Boolean, 代表 assertion 的 结果 ， 可 以 用 它 从 测试 中 提早 返回 ， 以 防 执 行 错误 ( 即 testrpc 显 示 的 错误 ) o 


- 有 许多 测试 钩 (hook) ， 参 见 下 面 的 例子 。 这 些 钓 包括 beforeAll、beforeBEach、afterAll 和 aftetrEach， 与 JavaSctript 测 试 中 
Mocha 提 供 的 一 样 。 在 进行 每 个 测试 之 前 或 之 后 ， 或 者 运行 每 个 程序 组 之 前 或 之 后 ， 可 以 使 用 这 些 钓 进行 设置 和 拆除 。 就 像 测试 
节 数 一 样 ， 每 个 钓 都 被 当 作 单一 交易 执行 。 注 意 ， 一些 复杂 测试 需要 进 量 设 置 ， 可 能 会 超过 单一 交易 的 gas 上 限 。 可 以 创建 
许多 有 不 同 后 级 的 钓 ， 绕 过 这 个 限制 。 示 例如 下 : 


import "truffle/Assert.sol"; 


contract TestHooks { 
uint someValue; 


function beforeEach() { 


someValue = 5; 


function beforeEachAgain() { 
someValue += 1; 


function testSomeValueIsSix() { 
uint expected = 6; 


Assert .equal (someValue, expected, "someValue should have been 6"); 
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置 它 ， 以 便 为 下 一 个 测试 做 准备 。 注 意 ， 就 像 JavaSctipt 测 试 一 样 ， 上 一 个 测试 函数 的 状态 将 延续 到 下 一 个 测试 函数 


Q ttruffe 无 法 直接 测试 出 合约 是 否 应 当 抛 出 异 第 〈 抛 出 异常 的 合约 说 明 有 预期 的 错误 ) 。 读 者 可 自行 查找 解决 方案 。 
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为 了 向 测试 合约 发 送 以 太 币 ， 在 合约 中 应 当 有 一 个 返回 uint 的 公共 函数 ， 叫 作 initialBalance。 这 可 以 直接 被 编写 成 函数 或 
者 公共 变量 。 当 测试 合约 被 部 署 到 网 络 中 时 ，truffle 将 从 测试 账户 友 送 设 数 量 的 以 大 币 到 测试 合约 。 在 测试 状态 下 ， 测 试 合约 随 
后 可 以 使 用 那些 以 太 币 设置 演示 以 太 币 交互 。 注 意 ，initialBalance 是 可 选项 ， 而 非 必 选 项 。 例 如 : 


Xx 


HE 


import "truffle/Assert.sol"; 
import "truffle/DeployedAddresses.sol"; 
import "../contracts/MyvConttract.sol"s 


contract TestContract { 
// Truffle will send the TestContract one Ether after deploying the 


COnLract. 
public uint initialBalance = 1 ether; 
function testInitialBalanceUsingDeployedContract() { 


MyContract myContract = MyContract (DeployedAddresses.MyContract()); 


// perform an action which sends value to myContract, then assert. 
myContract.send(...); 


function (t) 


{ 


// This will NOT be executed when Ether is sent. o/ 
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3. 运 行 测试 


要 运行 测试 脚本 ， 请 运行 如 下 命令 : 


truffle test 


或 者 ， 可 以 给 想 运 行 的 特定 文件 指定 一 个 路 径 。 比 如 ， 


truffle test ./path/to/test/file.js 


8.4.7 BEH 


truffleg (package) 


IB 


E 合 约 及 其 artifacts 的 集合 。 一 个 包 可 以 依赖 于 零 个 或 者 多 个 包 ， 即 使 用 包 的 智能 合约 和 


artifacts。 当 使 用 自己 项 目的 包 时 ， 在 两 个 地 方 将 会 使 用 包 的 智能 合约 和 artifacts: 项 目的 合约 里 ; 项 目的 Javascript 代 码 ( 移 


植 和 测试 ) 里 。 


用 truffle 创 建 的 项 目 默 认 有 特定 的 布局 ， 这 使 它们 能 够 当 作 包 使 用 。truffle 包 中 最 重要 的 目录 如 下 : 


- / contracts o 


- /build/contracts (由 truffle 创 建 ) 。 


第 一 个 目录 是 合约 目录 ， 其 中 包括 原始 Solidity 合 约 ; 第 二 个 目录 是 /build/contracts 目 录 ， 其 中 以 ,json 文件 形式 包含 创建 


artifact, 


truffle 文 持 两 种 包 构建 : npm 和 ethpm 包 。 必 须知 道 npm 包 是 什么 。 先 来 看 ethpm 包 是 什么 。ethpm 是 以 太 坊 的 包 注 册 中 
心 。 可 以 在 https://www.ethpm.com/ 发 现 所 有 ethpm 包 。 它 遵循 
ERC190 (https://github.com/ethereum/EIPs/issues/190) 规范 发 布 和 使 用 智能 合约 包 . 


truffle 默 认 与 npm 进 行 整合 ， 且 知道 项 目 node modules 目 录 (如 果 仔 在 ) 。 这 意味 着 可 以 通过 npm 使 用 和 分 配合 约 或 者 
库 ， 使 用 户 代 码 对 其 他 人 可 用 以 及 使 其 他 人 的 代码 对 用 户 可 用 。 还 可 以 使 项 目 中 有 一 个 package.json 文 件 。 可 以 在 项 目 中 简单 
安装 任何 npm 包 ， 并 在 任何 JavaScript 文 件 中 导入 它 ， 但 是 只 有 在 它 包含 前 面 提 到 的 两 个 目录 的 情况 下 才 会 被 称 为 truffle 包 。 在 
truffle 项 目 中 安装 npm 包 ,与 在 任何 node.js app 中 安装 npm 包 相同 。 


2. 通 过 ethpm 进 行 包 管理 


在 安 洲 ethpm 包 时 ， 如 果 没 有 installed_contracts 目 录 ， 束 创建 一 个 。 该 目录 可 以 用 类 似 于 node_modules 目 录 的 方式 处 
I, 
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truffle install «package name» 
还 可 以 安 六 特定 版 本 的 包 : 


truffle install «package name>(@<version> 


就 像 NPM 一 样 ，ethpm 版 本 遵循 语义 版 本 。 项 目 还 可 以 定义 一 个 ethpm.json 文 件 ， 它 对 于 npm 包 来 说 类 似 于 
package.jjson。 为 了 安装 ethpm.json 文 件 中 列 出 的 所 有 相关 内 容 ， 运 行 如 下 代码 : 


truffle install 


ethpmJjson 文 件 的 示例 如 下 : 


"package name": "adder", 
"Versions e03"; 
"description": "Simple contract to add two numbers", 
"adthors"s | 
"Tim Coulter <tim.coulter@consensys.net>" 
E 
"keywords": | 
"ethereum", 
"addltron" 


E 


"dependencies": { 


"owned": "^0.0.1" 


- 


"license": "MIT" 


o 为 truffle 创 建 和 发 布 hppm 包 的 过 程 与 创建 任何 其 他 npm 包 相同 。 学 习 如 何 创 建 和 发 布 ethpm 包 ， 请 访 
问 http://truffleframework.com/docs/getting_started/packages-ethpm#publishing-your-own-package。 无 论 是 否 把 包 当 作 npm 包 或 者 
ethpm 包 发 布 ， 都 需要 运行 truffle networks--clean 命 令 。 运 行 该 命令 时 ， 它 会 删除 所 有 那些 只 匹配 配置 文件 中 * 通 配 符 的 网 络 ID 的 
attifact。 之 所 以 这 样 做 ， 是 因为 这 些 地 址 对 于 其 他 也 使 用 这 个 包 的 项 目 来 说 是 非法 的 ， 这 些 网 络 很 有 可 能 是 私有 的 ， 因 为 它们 只 
用 于 开发 目的 。 除 非 你 知道 自己 在 做 什么 ， 否 则 不 要 忽略 这 个 命令 。 它 不 能 删除 任何 以 第 数 形式 出 现 的 私有 网 络 attifact， 所 以 需 
有 要 手动 删除 。 


3. 在 合约 中 使 用 包 的 合约 


为 了 在 合约 中 使 用 包 的 合约 ， 可 以 简单 使 用 Solidity 的 导入 语句 。 如 果 import 路 径 不 明确 或 者 完全 相关 ， 它 束 告 诉 truffle 从 
一 个 有 特定 名 字 的 包 中 寻找 一 个 文件 。 看 看 这 个 example-truffle-library 的 例子 (https://github.com/ConsenSys/example- 
truffle-library) : 


import "example-truffle-library/contracts/SimpleNameRegistry.sol"; 


由 于 路 径 的 开头 不 是 “./”，truffle 知 道 要 在 项 目 node_ modules 或 者 installed_contracts 目 录 中 寻找 example-truffle- 
library 文 件 夹 ， 以 提供 所 要 求 的 合约 的 路 径 。 


4. 在 JavaScript 代 码 中 使 用 包 的 artifact 


如 果 在 JavaScript 代 码 中 与 一 个 包 的 artifact 进 行 交 互 ， 仪 需要 包 的 .json 文 件 ， 然 后 使 用 truffle-contract 把 它们 转 为 可 用 抽 
象 : 


var contract = require("truffle-contract"); 

var data = require("example-truffle- 
library/build/contracts/SimpleNameRegistry.json"); 
var SimpleNameRegistry - contract(data); 


5. 企 Solidity 中 访问 已 经 部 署 package 合 约 的 地 址 


有 时 ， 用 户 可 能 希望 合约 与 包 之 前 部 署 的 合约 进行 交互 。 由 于 部 署 的 地 址 位 于 包 的 .json 文 件 中 ，solidity 代 码 不 能 直接 读 取 
文件 内 容 。 因 此 ， 要 让 solidity 代 码 访问 .json 文 件 中 的 地 址 ， 应 通过 在 Solidity 代 码 中 定义 函数 设置 相关 合约 地 址 ， 在 部 署 合 约 
之 后 ， 使 用 Javascript 调 用 那些 久 数 设置 相关 合约 地 址 。 


所 以 ， 可 以 这 样 定义 合约 代码 : 
import "example-truffle-library/contracts/SimpleNameRegistry.sol"; 


contract MyContract { 
SimpleNameRegistry registry; 
address public owner; 


function MyContract { 
owner - msg.sender; 


// Simple example that uses the deployed registry from the package. 
function getModule(bytes32 name) returns (address) { 
return registry.names (name); 


j 


// Set the registry if you're the owner. 
function setRegistry(address addr) { 
if (msg.sender !- owner) throw; 


registry - SimpleNameRegistry (addr); 


移植 应 该 看 起 来 像 这 样 : 


var SimpleNameRegistry = artifacts.require("example-truffle- 
library/contracts/SimpleNameRegistry.sol"); 


module.exports = function(deployer) { 
// Deploy our contract, then set the address of the registry. 
deployer.deploy(MyContract).then(function() { 
return MyContract.deployed(); 
}) .then(function(deployed) { 


return deployed.setRegistry (SimpleNameRegistry.address) ; 
i); 
ti 


8.4.8 使 用 truffle 的 操作 台 


有 时 ， 为 了 进行 测试 和 调试 ， 需 要 与 合约 进行 直接 交互 或 者 手动 执行 交易 。truffle 通 过 交互 操作 台 提 供 了 一 个 简便 的 办 法 
一 一 在 其 中 合约 可 用 且 随 时 可 用 。 


要 打开 操作 人 台 ， 请 运行 如 下 命令 : 


truffle console 


操作 人 台 根 据 项 目 配置 连接 到 一 个 以 太 坊 节点 。 前 面 的 命令 还 用 --network 选 项 指定 要 连接 到 的 特定 节 点 。 

操作 人 台 的 功能 如 下 : 

. 可 以 在 操作 台中 运行 命令 。 例如， 可 以 在 操作 台中 输入 migrate--reset， 其 效果 与 在 操作 台 外 运行 truffle migrate - teset 一 样 。 
- 所 有 已 编译 合约 都 是 可 用 的 ， 且 随时 可 用 。 

- 在 每 个 命令 (例如 migrate--treset) 之 后 ， 合 约 被 重新 配置 ， 所 以 可 以 立即 开始 使 用 新 分 配 的 地 址 和 二 进 制 。 

-Web3 对 象 可 用 ， 且 连接 到 以 太 坊 节点 。 


- 所 有 返回 承诺 的 命令 都 将 自动 执行 ， 并 打印 出 结果 ， 这 样 对 于 简单 命令 就 不 需要 使 用 .then ( 了 。 例 如 ， 可 以 这 样 写 代 
fil, : 


MyContract.at ("Oxabcd...").getValue.call(); 


849 在 truffle 环 境 中 运行 外 才 脚 本 

用 户 可 能 经 单 想 运 行 与 自己 合约 交互 的 外 部 脚本 。Truffle 提 供 了 便捷 的 方式 ， 基 于 用 户 想 要 的 网 络 局 动 合约 ， 并 根据 项 目 
配置 自动 连接 至 以 大 坊 节 点 。 

要 运行 外 部 脚本 ， 请 执行 如 下 命令 : 


truffle exec «path/to/file.js» 


为 了 正确 运行 外 部 脚本 ，truffle 期 望 它们 导出 一 个 把 单一 参数 作为 回调 遂 数 的 水 数 。 用 户 可 以 在 该 脚本 中 做 任何 想 做 的 事 ， 
只 要 脚本 结束 时 会 调用 回调 水 数 。 回 调 尔 数 接受 error (错误 ) 作为 第 一 个 和 唯一 一 个 参数 。 如 果 出 现 error， 执 行将 停止 ， 进 程 
将 返回 一 个 非 零 退出 代码 。 


外 部 脚本 必须 遵循 如 下 结构 : 


module.exports = function(callback) { 
// perform actions 
callback (); 


8.4.10 truffle 的 创建 管线 


介绍 了 用 truffle 编 译 、 部 署 和 测试 智能 合约 的 方法 之 后 ， 现 在 来 为 altcoin 创 建 一 个 客户 端 了 。 在 了 解 如 何 用 truffle 创 建 客 
户 端 之 前 ， 需 要 知道 ， 不 允许 我 们 使 用 在 以 大 坊 节 点 之 外 存储 的 账户 签署 交易 ， 也 就 是 说， 它 没有 类 似 于 sendRawTransaction 
的 东西 ， 理 由 与 truffle-contract 的 理由 相同 。 


用 truffle 创 建 客户 端 意味 着 首先 在 客户 端 源 代码 中 整合 truffle 的 artifact， 然 后 让 客户 端的 源 代码 做 好 部 署 准备 。 
创建 客户 端 需要 运行 如 下 命令 : 


truffle build 


HITR SH, truffles (AW MIA E BOR SCPErRBS builds EGER S Aum. 
1. 运 行 外 部 命令 


可 以 用 命令 行 工具 创建 客户 端 。 如 果 build 属 性 是 一 个 字符 串 ，truffle 就 假定 想 运行 一 个 命令 去 创建 客户 端 ， 所 以 它 把 该 字 


符 捉 当 作 一 个 命令 运行 。 给 该 命令 提供 足够 环境 变量 ， 用 这 些 变量 与 truffle 整 合 。 


可 以 计 上 truffle 运 行 一 个 命令 行 工 具 ， 以 创建 使 用 类 似 配置 代码 的 客户 新: 


module.exports = { 

// This will run the &grave;webpack&grave; command on each build. 

/ / 

// The following environment variables will be set when running the 
command: 


// WORKING DIRECTORY: root location of the project 

// BUILD DESTINATION DIRECTORY: expected destination of built assets 

// BUILD CONTRACTS DIRECTORY: root location of your build contract files 
[,501.78) 

/ / 

build: "webpack" 
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提供 大 量 关 于 项 目的 信息 ， 用 这 些 信息 与 truffle 整 合 。 


可 以 i 上 truffle 运 行 一 个 水 数 ， 以 创建 使 用 类 似 配 置 代码 的 客户 闹 : 


module.exports = 1 
build: function (options, callback) 1 


// Do something when a build is required. & grave; options&grave; 
contains these values: 


/ / 

// working directory: root location of the project 

// contracts directory: root directory of .sol files 

// destination directory: directory where truffle expects the built 
assets (important for &grave;truffle serve&grave;) 


j 


aD 还 可 以 创建 一 个 对 和 象 ， 其 中 包含 一 个 和 这 里 类 似 的 创建 方法 。 这 对 于 想 发 布 一 个 包 来 创建 客户 端的 人 来 说 实在 太 棒 
7! 


3.truffle 的 默认 构建 器 


truffle 提 供 了 truffle-default-builder npm 包 一 一 在 truffle 中 称 为 默认 构建 器 (default builder) 。 该 构建 器 导出 一 个 对 
象 ， 访 对 象 有 一 个 build 方 法 ， 它 的 工作 方式 与 之 前 提 到 的 方法 完全 一 样 。 


默认 构建 器 可 用 于 为 DApp 创 建 一 个 网 络 客户 病 ， 其 服务 决 只 服务 于 静态 文件 ， 所 有 功能 都 企 前端 。 
在 进一步 了 解 如 何 使 用 默认 构建 器 之 前 ， 首 先 用 如 下 命令 进行 安 委 : 


npm install truffle-default-builder --save 


现 将 配置 文件 修改 如 下 : 


var DefaultBuilder = require("truffle-default-builder"); 


module.exports = { 
networks: { 
development: { 
hose: “Localhost”; 
port: 8545, 
network id: "10" 


- 
live: { 
Höst: "LocalDost'. 
ports 82545, 
network id: "1" 
i 
- 
build: new DefaultBuilder ({ 
"index.html: "mdex.HEmrL", 
"pp. qms d 
"javascripts/index.js" 
] ， 
"bootstrap.min.css": "stylesheets/bootstrap.min.css" 
;) 


}; 


默认 构建 器 可 使 用 户 完全 掌控 组 织 客户 端 文件 和 文件 夹 的 方法 。 


该 配置 用 文件 、 文 件 夹 和 文件 数组 这 些 构成 目标 值 (targets) 的 内 容 (Gill) 描述 目标 值 ( 左 侧 ) 。 每 个 目标 值 将 通过 处 
理 右 侧 的 文件 产生 ， 要 进行 文件 扩 序 、 把 结果 连接 在 一 起 ， 然 后 保存 结果 文件 ( 即 目标 值 ) 到 创建 目的 地 。 这 里 ， 字 符 串 (而 非 
数组 ) 在 右 侧 指 明 ， 且 那个 文件 将 被 处 理 (如 果 有 需要 ) ， 然 后 被 直接 复制 。 如 果 字 符 串 结尾 是 “/”， 束 被 翻译 为 目录 ， 不 对 
该 目录 进行 任何 处 理 直 接 复制 。 右 侧 指 明 的 所 有 路 径 都 与 app/ 目 录 有 关 。 


可 以 随时 修改 该 配置 和 目录 结构 。 比 如 不 需要 有 JavaScript 和 stylesheets 目 录 ， 但 是 请 确保 相应 修改 了 配置 。 


qp 如 果 布 望 默 认 构 建 器 在 Web 应 用 前 端 整 合 truffle， 就 要 确保 有 一 个 创建 目标 ( 叫 作 app.js) ， 默 认 构 建 器 可 以 对 其 附加 
代码 。 它 不 会 将 ttuffle 与 其 他 任何 文件 名 整合 。 


默认 构建 器 的 功能 如 下 : 
自动 将 已 编译 合约 artifact、 已 部 署 合约 信息 和 以 大 坊 节点 配置 导入 客户 端 源 代码 。 
包括 受 推荐 的 相关 程序 ， 包 括 web3 和 和 truffle-contract。 
- 编译 ES6 和 JSX 文 件 。 
编译 SASS 文 件 。 


- 最 小 化 asset 文 件 。 


Q 可 以 使 用 truffle watch 命 令 ， 监 听 合 约 目 录 、 应 用 目录 和 配置 文件 的 变化 。 如 有 变化 ， 它 就 重新 编译 合约 ， 并 生成 新 


的 artifact 文 件 ， 然 后 重新 创建 客户 端 。 但 是 它 不 进行 移植 和 测试 。 
4. BE Pin 


现在 为 DApp 编 写 一 个 客户 端 ， 并 使 用 truffle 的 默认 构建 器 创建 客户 端 。 首 先 ， 在 前 面 做 好 的 配置 中 创建 文件 和 目录 : 创建 
一 个 app 目 录 ， 在 里 面 创 建 一 个 index.html 文 件 和 两 个 目录 (分 别称 为 JavaScript 和 styelsheets) 。 在 Javascript 目 录 中 ， 创 建 
index.js 文 件 。 在 stylesheets 目 录 中 ， 下 载 并 放 入 Bootstrap 4 的 CSS 文 件 。 详 见 https://v4-alpha.getbootstrap.com/getting- 


started/downloads/#bootstrap-css-and-js。 


在 index.html 文 件 中 ， 添 加 如 下 代码 : 


<!doctype html» 
«html» 
«head» 
<link rel="stylesheet" type="text/css" href="bootstrap.min.css"> 
</head> 
<body> 
<div class="container"> 
«div oclass-"row"» 
«div class-"col-md-6"» 
«br» 
<h2>Send Metacoins</h2> 
<hr> 
<form id="sendForm"> 
<div class-"form-group"» 


«label for="fromAddress">Select Account Address</label> 
«select class-"form-control" id="fromAddress"> 
«/select» 
< disr> 
<div class-"form-group"-» 
<label for="amount">How much metacoin do you want to send? 
</label> 
<input type="text" class-"form-control" id-"amount"» 
</div> 
<div class="form-group"> 
«label for="toAddress">Enter the address to which you want to 
send matacoins</label> 
<input type="text" class-"form-control" id="toAddress" 
placeholder="Prefixed with Ox"> 
«/div» 
«button type="submit" class="btn btn-primary">Submit</button> 
«/ form» 
«/div» 
«div class-"col-md-6"» 
«Dr» 


<h2>Find Balance</h2> 

chr 

«form id="findBalanceForm"> 

«div class="form-group"> 
«label for="address">Select Account Address</label> 
«select class-"form-control" id="address"> 


«/select» 
edax 
«button type="submit" class="btn btn-primary"»Check 
Balance</button> 

</form> 

Ae le 

</div> 

Edw 

«script type-"text/javascript" src="/app.js"></script> 

«/body» 
«/html» 


<!doctype html» 
<html> 
<head> 
<link rel="stylesheet" type="text/css" href="bootstrap.min.css"> 
</head> 
<body> 
<div class="container"> 
<div class="row"> 
<div clLass="Col-—md-6"> 
<br> 
<h2>Send Metacoins</h2> 
«hr 
«form id="sendForm"> 
«div class-"form-group"» 
«label for="fromAddress">Select Account 


Address«/label» 
<select class-"form-control" id="fromAddress"> 
</select> 
</div> 
«div class="form-group"> 
<label for="amount">How much metacoin you want 
to send?</label> 
<input type="text" class-"form-control" 
id-"amount"» 
«/div» 
«div class-"form-group"» 
«label for="toAddress">Enter the address to 
which you want to send matacoins</label> 
<input type="text" class-"form-control" 


id-"toAddress" placeholder="Prefixed with Ox"» 
L FAIN 
<button type="submit" class="btn btn- 
primary">Submit</button> 
</Torm 
</div> 
<O1y cplass"ecol-me-e*» 
chro 
<h2>Find Balance</h2> 
< 
<form id="findBalanceForm"> 
«div class-"form-group"» 
«label for="address">Select Account 
Address</label> 
<select class-"form-control" id="address"> 
</select> 
or 
«button type="submit" class-"btn btn- 
primary"»Check Balance</button> 
«/form» 
</div> 
</div> 
</div> 
<script type-"text/javascript" src="/app.js"></script> 
</body> 
</html> 


在 程序 代码 中 ， 加 载 bootstrap.min.css 和 app.js 文 件 。 有 两 种 形式 : 一 种 是 友 送 Metacoins 给 一 个 不 同 的 账户 ;， 另 一 种 是 查 
询 账户 中 的 Metacoins 余 额 。 在 第 一 种 形式 中 ， 用 户 必 须 选 择 一 个 账户 ， 然 后 输入 要 友 送 的 Metacoin 数 量 和 想 要 友 送 到 的 地 
址 。 在 第 二 种 形式 中 ， 用 户 只 需要 选择 要 查询 Metacoins 余 额 的 账户 地 址 。 


在 index.js 文 件 中 ， 添 加 如 下 代码 : 


window.addEventListener("load", function()t 
var accounts = web3.eth.accounts; 


"m. 
, 


var html - 


for(var count = 0; wun 小) 


{ 


count « accounts.length; 


html = html + "<option>" + accounts[count] + "</option>"; 


document.getElementById("fromAddress").innerHTML = html; 

document.getElementById("address").innerHTML -» html; 

MetaCoin.detectNetwork(); 
}) 
document.getElementById("sendForm").addEventListener("submit", function (e) { 

e.preventDefault (); 

MetaCoin.deployed().then(function(instance) { 

return 
instance.sendCoin(document.getElementById("toAddress").value, 
document.getElementById("amount").value, { 
from: 


document.getElementById("fromAddress").options[document.getElementById("fro 
mAddress").selectedIndex].value 


3); 


}) .then(function(result) { 


alert ("Transaction mined successfully. Txn Hash: " + result.tx); 
}) .catch (function (e) { 
alert ("An error occured"); 
}) 
}) 
document.getElementById("findBalanceForm").addEventListener("submit", 
function (e) { 
e.preventDefault (); 
MetaCoin.deployed().then(function(instance) { 
return 
instance.getBalance.call(document.getElementById("address").value); 


}) .then(function(result) { 
console.log(result); 
alert("Balance is: " 

)).catch(function(e)(í 
alert("An error occured"); 


+ result.toString() + " metacoins"); 


}) 
}) 


上 述 代码 的 执行 过 程 如 下 : 
1) truffle-default-builder 人 更 artifacts 对 象 企 “contracts_ 全 局 对 象 下 可 用 。 


2) 使 可 用 的 合约 抽象 对 所 有 作为 全 局 变量 (变量 名 与 合约 名 相应 ) 的 合约 可 用 。 


3) 通过 已 经 设置 provider 提 供 web3 对 象 
在 ， 则 默认 值 是 http://localhost: 8545, 


为 合约 抽象 设置 provider。 还 使 web3 对 象 连接 到 带 名 字 开 发 的 网 络 ， 如 果 不 存 


4) 在 程序 代码 中 ， 首 先 等 待 页 面 加 载 ， 加 载 后 在 连接 的 节点 中 检索 账 己 列表， 并 在 两 张 表 中 显示 。 还 要 调用 MetaCoin 


abstraction 的 detectNetwork () 方法 。 


5) 设置 两 张 表 的 submit 事 件 触 友 器 。 它 们 两 个 都 在 提示 栏 显示 结 
6) 当 提 交 第 一 张 表 时 ， 获 得 MetaCoin 合 约 的 部 署 实 例 ， 并 用 正确 的 实 参 调 用 sendCoin 方 法 。 
—— /NXXx EJ 


7) 当 提交 第 二 张 表 时 ， 在 EVM 中 用 调用 get Balance 方 法 检索 被 选择 账户 的 余额 ， 而 非 广播 一 个 交易 。 


继续 运行 truffle 创 建 命 令 ，truffle 会 在 build 目 录 中 创建 index.html、app.js 和 bootstrap.min.css 文 件 ， 并 在 这 些 文件 中 放 
入 客 尸 新 的 最 终 部 署 代码 。 


8.4.11 truffle 的 服务 器 端 


truffle 有 内 置 Web 服 务 问 。 访 服务 端 只 服务 于 build 目 录 中 有 正确 的 MIME 类 型 集 的 文件 。 除 此 之 外 ， 它 没有 别 的 作用 。 

要 运行 Web 服 务 端 ， 请 运行 如 下 命令 : 

truffle serve 

服务 新 默 认 在 端口 8080 运 行 。 但 是 可 以 使 用 -p 选 项 来 指定 一 个 不 同 的 端口 。 

类 似 于 truffle watch， 该 Web 服 务 端 还 监听 合约 目录 、 应 用 目录 和 配置 文件 的 变化 。 当 有 变化 时 ， 它 重新 编译 合约 并 生成 
新 的 artifact 文 件 ， 然 后 重新 创建 客户 端 。 但 是 它 不 执行 移植 和 测试 。 


由 于 truffle-default-builder 把 最 终 可 部 署 代码 放 入 创建 目录 中 ， 因 此 只 需 运 行 truffle serve 即 可 通过 网 络 为 文件 提供 服 


务 。 


下 面 测试 Web 客 户 端 。 访 问 http://localhost: 8080, 会 看 到 与 图 8-1 类 似 的 界面 。 


Send Metacoins Find Balance 


Select Account Address Select Account Address 


<> 


Oxde55f78fc7831c749a82cf5ee777a97 1d57abbecf 一 0xde55f78fc7831c749a82cf5ee777a971d57abbcf 


How much metacoin you want to send? Check Balance 


Enter the address to which you want to send matacoins 


Prefixed with Ox 





图 8-1 


GO 


用 户 看 到 的 选择 框 的 账户 地 址 各 不 相同 。 在 部 署 合约 时 ， 合 约 把 所 有 metacoin 分 配给 部 署 合 约 的 地 址 ， 所 以 第 一 个 账户 的 
余额 为 10000 个 元 币 。 现 在 从 第 一 个 账户 发 送 5 个 metacoin 到 第 二 个 账户 ， 并 按 下 Submit 按 钮 ， 可 以 看 到 界面 显示 内 容 与 图 8-2 


所 示 的 界面 类 似 。 


Send Metacoins Find Balance 


Select Account Address Select Account Address 


Oxde55f78fc7831c749a82cf5ee777a97 1d57abbcf Oxde55f78fc7831c749a82cf5ee777a97 1d57abbcf 


How much metacoin you want to send? Check Balance 


<> 
4» 





5 
Enter the address to which you want to send matacoins localhost:8080 says: 
Transaction mined successfully. Txn Hash: 
Oxe07aB0debe64296ff91619671999fa596ef249aac139f11 
0x7f933a37039d497d1cc9698e1f03981410e11873 napi € MEE ab96ef249aac 


_ | Prevent this page from creating additional dialogues. 





图 82 


现在 查询 第 二 个 账户 的 余额 ， 选 择 第 二 张 表 选 择 框 中 的 第 二 个 账户， 然后 按 下 Check Balance 按 钮 ， 可 以 看 到 界面 显示 内 容 
与 图 8-3 所 示 的 界面 类 似 。 





Send Metacoins Find Balance 
Select Account Address Select Account Address 
Oxde55f78fc7831c749a82cf5ee777a971d57abbcf $ 0x7f933a37039d497d1cc9698e1f03981410e11873 $ 
How much metacoin you want to send? Check Balance 
5 
Enter the address to which you want to send matacoins localhost:8080 says: 


Balance is: 5 metacoins 


0x71933a37039d497d1cc9698e1f03981410e11873 


_ | Prevent this page from creating additional dialogues. 


| Submit | OK K 





图 8-3 


8.5 f 


在 术 章 中 ， 我 们 深入 学 习 了 如 何 用 truffle 创 建 DApp 及 其 客户 端 ， 以 及 truffle 如 何 使 编写 、 编 译 、 部 署 和 测试 DApp 交 得 简便 。 
其 实 ， 在 转换 客户 端 网 络 时 使 用 truffle-contract 很 简单 ， 不 需要 修改 源 代 码 。 


SI ”创建 联盟 区 块 链 


联盟 (通常 捐 有 多 个 参与 者 的 联盟 ,例如 银行 、 电 子 两 务 网 站 、 政 府 部 门 、 医 阮 等 ) 可 以 应 用 区 块 链 技术 解决 诸多 问题 ， 并 


使 解决 过 程 更 方便 、 解 决 费用 更 低 。 尽 管 人 们 知道 区 块 链 能 够 帮助 他 们 ， 但 需要 明确 的 是 以 大 坊 区 块 链 并 不 适用 于 所 有 情况 。 有 
一 些 区 块 链 实现 (例如 Hyperledger) 是 专门 为 联盟 创建 的 。 随 着 在 本 书 中 对 以 太 坊 的 学 习 ， 我 们 将 看 到 可 以 如 何 改进 以 太 坊 ， 

以 创建 联盟 区 块 链 。 本 章 会 使 用 parity 创 建 联 盟 区 块 链 。 尽 管 parity 有 其 他 的 替代 (例如 J.P.Morgan 的 quorum) ， 我 们 还 是 选 
用 parity， 因 为 在 写本 书 之 时 它 已 经 存在 了 一 段 时 间 ， 不 少 企业 已 经 使 用 了 parity 而 非 其 他 实现 。 但 parity 并 不 一 定 总 是 最 佳 解 

决 方案 ， 因 此 在 决定 使 用 哪 种 实现 之 前 ， 最 好 先 了 解 一 下 其 他 实现 。 


在 本 章 中 ， 我 们 将 讲解 如 下 内 容 : 
:以太 坊 不 适用 于 联盟 区 块 链 的 原因 。 
:patity 节 点 的 概念 及 其 功能 。 
- 权威 证 明 共 识 (Proof-of-Authority, PoA) 协议 的 概念 。patity 支 持 哪 种 类 型 的 PoA? 
> Auta 共 识 协议 的 工作 原理 。 
-下载 和 安装 patity。 


- 使 用 patity 创 建 联盟 区 块 链 。 


9.1 什么 是 联盟 区 块 链 


为 了 理解 联盟 区 块 链 是 什么 ,或 者 换 句 话说 ， 联 盟 需要 什么 样 的 区 块 链 实现 ， 让 我 们 先 看 一 个 例子 。 银 行 想 创建 一 个 区 块 
链 ， 以 使 转账 更 万 便 、 快 捷 、 便 宜 。 那 么 ， 他 们 的 需求 如 下 : 


1) 速度 。 他 们 需要 区 块 链 网 络 能 接近 实时 确认 交易 。 目 前 ， 以 太 坊 区 块 链 网 络 区 块 时 间 为 12s， 在 确认 交易 之 前 客 尸 新 通 


2) 许可 权限 (permissioned) 。 他 们 希望 区 块 链 是 有 许可 权限 的 。 许 可 本 身 有 多 种 谷 义 。 例 如 允许 加 入 到 网 络 中 的 许可 、 
创建 区 块 的 许可 、 友 送 特定 交易 的 许可 等 。 


3) 安全 。PoW 对 于 私有 网 络 还 不 够 安全 ， 因 为 只 有 一 定数 量 的 参与 者 ， 所 以 没有 产生 足够 的 算 力 保障 其 安全 ， 所 以 需要 一 
种 能 够 使 区 块 链 安全 、 不 可 改变 的 共识 协议 。 


4) 隐私 。 尽 管 网 络 是 私有 的 ， 在 网 络 目 身 中 还 需要 隐私 。 共 有 以 下 两 种 隐私 。 


@ 身 份 隐私 。 身份 隐私 使 身份 不 可 追踪 。 此 前 我 们 看 到 的 获取 身份 隐私 的 万 法 是 使 用 多 个 以 太 坊 账 尸 地 址 。 但 是 如 果 使 用 多 
个 以 太 坊 账户 ， 则 智能 合约 不 能 通过 所 有 验证 ， 因 为 无 法 知道 所 有 这 些 账户 是 否 真 的 属于 同一 个 用 户 。 


@ 数 据 隐 私 。 有 时 候 ， 我 们 希望 数据 只 对 特定 节点 可 见 ， 而 不是 对 网 络 中 的 所 有 节点 可 见 。 


忌 之 ， 在 本 章 中 ， 我 们 将 学 习 如 何在 以 太 坊 中 解决 这 些 问 题 。 


9.2 ”什么 是 权威 证 明 共 识 


权威 证 明 共 识 是 一 种 区 块 链 共识 机 制 ， 达 成 共识 的 方式 是 引用 一 个 验证 器 (validator， 用 于 物理 实体 时 被 称 为 权威 机 构 ) 
列表 。 验 证 器 是 一 群 被 允许 加 入 共识 的 账户 /节点 ， 用 于 验证 交易 和 区 块 。 


与 PoW 或 者 PoS 不 同 ， 这 里 不 涉及 挖 矿 机 制 。PoA 协 议 有 多 种 类 型 ， 并 且 它 们 的 工作 原理 各 不 相同 。Hyperledger 和 Ripple 
均 基于 PoA。 其 中 ，Hyperledger 使 用 PBFT， 而 Ripple 使 用 一 个 达 代 过 程 。 


9.3 parity 概述 


parity 是 一 个 彻头彻尾 的 以 大 坊 节点 ， 其 特点 包括 正确 性 /可 验证 性 、 模 块 化 、 低 内 存 占用 和 高 性 能 。 它 是 用 Rust 编 程 语言 
编写 的 ，Rust 是 一 种 混合 式 的 、 面 向 对 象 的 为数 式 语 言 的 语言 ， 注 重 效率 ， 由 Parity Technologies 公 司 开 发 。 在 写本 书 
时 ，parity 的 最 新 版 本 是 1.7.0， 我 们 将 使 用 这 个 版 本 学 习 创建 联盟 区 块 链 需 要 的 内 容 。 如 要 深入 学 习 parity， 请 参考 官方 文档 。 


parity 的 功能 比 go-ethereum 多 ， 例 如 有 web3 DApp 浏 览 器 和 更 先进 的 账户 管理 功能 等 。 不 过 parity 的 特别 之 处 在 于 它 既 
支持 PoA， 也 支持 PoW。parity 目 前 支持 Aura 和 Tendermint PoA 协 议 ， 未 来 还 可 能 支持 更 多 的 PoA 协 议 。 目 前 ，parity 推 荐 使 
用 Aura， 而 不 推荐 Tendermint， 因 为 Tendermint 仍 处 于 开发 阶段 。 


对 于 获得 许可 权限 的 区 块 链 来 说 ，Aura 是 一 个 比 PoW 好 得 多 的 选择 ， 因 为 它 的 区 块 时 间 更 好 ， 且 在 私有 网 络 中 提供 了 更 好 
的 安全 性 。 


9.3.1 Aura 的 工作 原理 


让 我 们 从 一 定 高 度 看 看 Aura 是 如 何 工作 的 。Aura 要 求 每 个 古 点 中 都 指明 同样 的 验证 器 列表 ， 这 是 参与 共识 的 账户 地 址 的 列 
表 。 一 个 节点 可 能 是 验证 书 点 ， 也 可 能 不 是 验证 节点 ， 即 使 是 验证 节操 ， 也 需要 有 这 个 列表 ， 这 样 它 目 己 才能 达成 共识 。 


这 个 列表 可 以 在 创 世 文 件 中 作为 静态 列表 提供 (如 果 验 证 器 的 列表 永远 保持 不 变 ) ， 或 者 在 智能 合约 中 提供 (这 样 它 可 以 被 
动态 更 新 且 让 每 一 个 书 点 都 知道 它 ) 。 人 在 智能 合约 中 ， 对 于 谁 可 以 添加 新 的 验证 器 ， 可 以 设置 不 同 的 策略 。 


区 块 时 间 可 以 在 创 世 文件 中 配置 。 用 户 可 以 自己 决定 区 块 时 间 。 在 私有 网 络 中 ， 低 至 3s 的 区 块 时 间 运 行 良 好 。 在 Aura 中 ， 
每 过 3s 吏 选择 验证 器 中 的 一 个 ， 访 验证 器 负责 创建 、 验 证 、 签 署 和 广播 区 块 。 用 户 不 需要 深入 理解 实际 的 选择 算法 ， 因 为 这 不 会 
影响 DApp 开 发 。 这 是 计算 下 一 个 验证 器 的 公式 : 

(UNIX_TIMESTAMP/BLOCK_TIME%NUMBER_OF_TOTAL VALIDATORS) 。 选 择 算法 很 智能 ， 它 给 所 有 人 同等 的 机 会 。 当 
其 他 厂 点 接收 一 个 区 块 时 ， 它 们 要 检查 区 块 是 否 来 自 下 一 个 合法 的 验证 器 ; 如 果 不 是 ， 束 拒绝 它 。 与 PoW 不 同 ， 验 证 器 创建 区 
块 的 时 候 ， 不 能 得 到 以 太 币 回报 。 在 Aura 中 ， 由 用 户 决 定 在 没有 交易 时 是 售 生 成 空 区 块 。 


如 果 由 于 一 些 原 因 ， 下 一 个 验证 器 节点 创建 和 广播 下 一 个 区 块 失 败 了 ， 情 况 会 如 何 ? 让 我 们 看 一 个 例子 : 假设 A 是 下 一 个 区 
块 ( 即 第 5 个 区 块 ) 的 验证 器 ，B 是 第 6 个 区 块 的 验证 器 。 假 设 区 块 时 间 是 5s。 如 果 A 广 播 区 块 失 败 ， 则 5s 之 后 轮 到 B 广 播 区 块 。 
所 以 事实 上 不 会 友 生 什 么 要 紧 事 ， 区 块 时 间 截 将 揭示 这 些 细 书 。 


在 PoW 中 两 个 矿工 同时 控 矿 ， 最 后 网 络 是 否 有 可 能 产生 多 个 不 同 的 区 块 链 ? 是 的 ， 很 多 情况 下 都 可 能 导致 这 样 的 结果 。 让 


我 们 看 个 例子 来 理解 一 种 可 能 友 生 的 情况 以 及 网 络 目 动 解决 冲突 的 万 法 。 假 设 共 有 5 个 验证 器 : A. B. C. DANE, KATA 
55。 假 设 A 首先 被 选中 并 广播 一 个 区 块 ， 但 是 由 于 一 些 原 因 区 块 没 有 到 达 D 和 E， 所 以 它们 会 认为 A 没有 广播 区 块 。 现 在 假设 选择 
算法 选择 B 来 生成 下 一 个 区 块 ， 则 B 将 在 A 区 块 之 上 生成 下 一 个 区 块 并 广播 给 所 有 的 节操 。D 和 E 将 拒绝 它 ， 因 为 前 一 个 区 块 哈 希 
不 匹配 。 由 此 ，D 和 E 将 形成 一 个 不 同 的 链 ， 而 A、B 和 C 将 形成 一 个 不 同 的 链 。 人 和、B 和 0C 将 拒绝 来 自 D 和 E 的 区 块 ， 而 D 和 E 将 拒绝 
来 自 A、B 和 C 的 区 块 。 这 个 问题 可 以 这 样 解决 ,假设 定义 来 自 A、B 和 C 的 区 块 比 来 自 D 和 E 的 区 块 更 准确 ， 因 此 D 和 E 将 用 A、B 和 
C 版 本 的 区 块 链 替换 上 自己 的 区 块 链 。 两 个 版 本 的 区 块 链 有 不 同 的 准确 分 ， 第 一 个 区 块 链 的 分 数 高 于 第 二 个 。 当 B 广 播 它 的 区 块 
时 ， 它 还 将 提供 其 区 块 链 评分 ， 因 为 其 分 数 高 ，D 和 E 束 用 B 的 区 块 链 蔡 换 上 自己 的 区 块 链 。 这 束 是 ;站 突 的 解决 方法 。 区 块 链 的 分 数 
使 用 (U128 max*BLOCK NUMBER OF LATEST BLOCK- (UNIX TIMESTAMP OF LATEST BLOCK/BLOCK TIME) ) it 
算 。 首 先 用 长 度 评分 (区 块 越 多 越 好 ) ， 对 于 有 同样 长 度 的 链 ， 选 择 最 后 一 个 区 块 比较 旧 的 链 。 


如 果 更 深入 地 学 习 Aura， 参 见 https://github.com/paritytech/parity/wiki/Aura.。 


9.2 ”运行 parity 
parity#s 2 272eRustheA. 16.07 Keb. HES rustup Rust, 
1.zcXrust 
如 果 还 没有 rustup， 可 以 按照 如 下 方式 进行 安装 。 
(1) Linux 
在 以 Linux 为 基础 的 操作 系统 上 ， 运 行 如 下 命令 : 


curl https://sh.rustup.rs -sSf | sh 


parity 还 要 求 安装 gcc、g++、libssl-dev/openssl、libudev-dev 和 pkg-config 包 。 
(2) OS X 
f£OS X 上 ， 运 行 如 下 命令 : 


curl https://sh.rustup.rs -sSf | sh 


parity 还 要 求 安装 clang。clang 来 自 Xcode 命 令 行 工具 ， 或 者 可 以 用 Homebrew 安 装 。 
(3) Windows 


确保 安装 可 使 用 C++ 的 Visual Studio 2015。 下 一 步 ， 从 https://static.rust-lang.org/rustup/dist/x86 64-pc-windows- 
msvc/rustupinit.exe 下 载 并 运行 rustup 安 六 程序 ， 启 动 VS2015 x64 Native Tools Command Prompt， 并 使 用 下 面 的 命令 安 
装 和 建立 msvc 工 具 链 : 


rustup default stable-x86 64-pc-windows-msvc 


2. 下 载 、 安 半 和 运行 parity 
1 


在 操作 系统 上 安 六 好 rust 之 后 ， 可 以 运行 如 下 简单 的 在 线 命 令 安 六 parity: 


cargo install --git https://github.com/paritytech/parity.git parity 


检测 是 否 已 经 安装 了 parity， 运 行 如 下 命令 : 
parity --help 


如 果 parity 安 妆 成 功 ， 惑 会 看 到 一 个 子 命令 和 选项 列表 。 


9.3.3 ”创建 私有 网络 


现在 是 时 候 建 立 联盟 区 块 链 了 。 使 用 Aura 作 为 共识 机 制 ， 创 建 两 个 彼此 连接 的 验证 节点 。 我 们 将 在 同一 人 台 计 算 机 上 建立 这 


1. 创 建 账户 
首先 ， 打 开 两 个 shel| 窗 口 。 第 一 个 针对 第 一 个 验证 器 ， 第 二 个 针对 第 二 个 验证 器 。 第 一 个 节点 包含 两 个 账户 ， 第 二 个 节点 
包含 一 个 账户 。 第 一 个 节点 的 第 二 个 账户 将 被 赋予 一 些 初 始 以 太 币 ， 这 样 网 络 将 拥有 一 些 以 太 币 。 


在 第 一 个 shel| 窗 口中 ， 运 行 如 下 命令 两 次 : 


parity account new -d ./validatorO 


两 次 都 会 要 求 输入 密码 。 现 阶段 ， 在 两 个 账户 中 输入 相同 的 密码 。 
在 第 二 个 shell 中 窗口 ， 运 行 如 下 命令 一 次 : 


parity account new -d ./validator1 


和 刚才 一 样 ， 输 入 密码 。 


2. 创 建 规 沁 文 件 
每 个 网 络 的 节点 都 分 享 一 个 通用 规 沁 文 件 (specification file) 。 该 文件 告诉 节点 关于 创 世 区 块 、 谁 是 验证 器 等 信息 。 我 们 


将 创建 一 个 智能 合约 ， 其 中 包含 验证 器 列表 。 有 了 两 种 类 型 的 验证 器 合约 : non-reporting 合 约 和 reporting 合 约 。 我 们 只 需要 提 


供 一 个 。 
这 两 种 验证 器 合约 的 区 别 是 : non-reporting 合 约 只 返回 一 个 验证 器 列表 ; 而 reporting 合 约 可 以 对 善意 (善意 行为 可 能 仪 
能 是 在 同一 步骤 释放 两 个 不 同 的 区 块 ) 采取 行动 。 


=z/ 


仅 是 不 从 一 个 给 定 的 验证 器 接收 区 块 ) 和 恶意 行为 GUAE I7JHIBEAE: 


non-reporting 合 约 至 少 应 该 有 如 下 界面 : 


{"constant":true, "inputs": [],"name":"getValidators", "outputs": [{"name":""," 
type": "address[]"}],"payable":false, "type": "function" } 


在 每 一 个 区 块 上 调用 getValidators 销 数 ， 以 决定 当前 列表 。 转 换 规则 是 由 实现 该 万 法 的 合约 决定 的 。 


reporting 合 约 至 少 应 该 有 如 下 界面 : 


[ 


i"constant"struüse,"inpnps"s[],T"Tname"s"*qetyvalidators","ourtpubS"s[i"name"7 wmm, n 
type":"address[]")],"payable":false,"type":"function");, 

i constant"sTalse,"nnputs";[14"name"s"valridator","type' ."address"r]|,"hame^:"* 
reportMalicious","outputs":[],"payable":;false,"type":"function";, 
("constant":false,"inputs":[í("name":"validator","type":"address")],"name":" 


reportBenign","oütputs":;[l,"pavable":false,"type":"fünction"j; 


当 有 善意 或 者 恶意 行为 时 ， 共 识 机 器 分 别 调用 reportBenign 和 reportMalicious 函 数 。 
创建 一 个 reporting 合 约 的 基本 示例 如 下 : 


contract ReportingContract 4 

address[] public validators - 
[0x831647ec69beA4Aca44ea4bd1b9909debfbaaefb55oc, 
0x12a6bda0d5f58538167b2efce5519e316863f9£fd]; 

mapping(address => uint) indices; 

address public dislikeg; 


function ReportingContract() { 


for (Unt L = 0; LL «4 yalidators.length; a+). 4 
indices[validators[i]] = i; 


// Called on every block to update node validator list. 


function getValidators() constant returns (address[]) { 
return validators; 


// Expand the list of validators. 
function addValidator(address validator) { 
validators.push(validator) ; 


// Remove a validator from the list. 

function reportMalicious(address validator) { 
validators[indices[validator]] = validators [validators.length-1]; 
delete indices [validator]; 
delete validators[validators.length-1]; 
validators.length--; 


function reportBenign(address validator) { 
disliked = validator; 


该 代码 无 须 解释 说 明 。 确 保 在 验证 器 中 ， 数 组 用 验证 器 1 的 第 一 个 地 址 和 验证 器 2 的 第 一 个 地 址 代 蔡 这 些 地 址 ， 因 为 我 们 将 
使 用 那些 地 址 进行 验证 。 现 在 编译 上 述 合约 。 


现在 创建 规范 文件 。 创 建 一 个 叫 作 spec,json 的 文件 ， 放 入 下 面 的 代码 : 


1 
"Hames "ernereunm", 
"engine": { 
"authorityRound"; ( 
"params"s - 

"gasLimitBoundDivisor": "0x400", 
"StepDuration": "5", 
"Uvalorddtors" s 4 
"contract": "0x0000000000000000000000000000000000000005" 


j 


E 


params “s 4 


"maximumExtraDataSize": "0x20", 
"nitocashimit"s X13897; 
"UuneBpwoTEID* x UUSS3937 
Ps 
"genesis": { 
"eri ss aud 
"authorityRound"z. 4 
"tenus Os. 


"signature": "0x00000000000000000000000000000000000000000 
000000000000000000000000000000000000000000000000000000 
00000000000000000000000000000000000" 


} 

fa 

"JLE rLCuüUIty T: "DXZUDDOT. 

"gasLimic": "OsS3B8DSg0" 

F 
ns 4 

"0x0000000000000000000000000000000000000001": { "balance": "1", 
"builtin": ( "name": "ecrecover", "pricing": ( "linear": ( "base": 3000, 
UWOPO'UEI O F F F OL 

"0x0000000000000000000000000000000000000002": { "balance": "1", 
"builtin"s: { "name": "sha2560", "pricing"; 4 "linear": { "base": 60, "word": 
ie FF F Js 

"0x0000000000000000000000000000000000000003": { "balance": "1", 
"Dulltin": { "name": "rripemadloU", "pricing": { “linear”: 4 “bese”: 900, 
"Wordg"s L20 T F t 4 

"0x0000000000000000000000000000000000000004": { "balance": "1", 
"balltin"s 4 "name": "identity", “pricing”: { "l1xnear'. { "Dase": 15, 
"word" t S3 F F E Fy 

"0x0000000000000000000000000000000000000005": { "balance": "1", 
"constructor" : "0x606060405260406040519081016040528073831647" }, 


"0x004ec07d2329997267Ec62b4166639513386F32E": ( "balance": 
"10000000000000000000000" } 
j 


上 述 程序 代码 的 工作 原理 如 下 : 


engine 属 性 用 于 设置 共识 协议 和 协议 具体 参数 。 这 里 的 engine 是 authority-Round， 也 就 是 aura。gasLimitBoundDivisor 决 定 gas 
上 限 调 整 ， 并 有 通常 的 以 太 坊 值 。 在 验证 器 属性 中 ， 有 一 个 contract 属 性 ， 即 reporting 合 约 的 地 址 。stepDuration 是 以 秒 为 单位 的 区 
块 时 间 。 


“ 在 params 属 性 中 ， 只 有 了 网络 ID 才 是 关键 ; 在 所 有 的 链 中 ， 其 他 属性 都 是 标准 的 。 
- genesis 属 性 对 于 authorityRound 共 识 有 一 些 标准 数值 。 
accounts 属性 用 于 列 出 网 络 中 存在 的 最 初 账户 和 合约 。 前 四 个 是 标准 以 太 坊 内 置 合约 ， 使 用 Solidity 合 约 编写 语言 应 当 包 括 


这 些 。 第 五 个 是 reporting 合 约 。 确 保 把 字 节 码 替 换 成 constructor 参 数 中 的 字 节 码 。 最 后 一 个 账户 是 在 验证 器 1 shell 生 成 的 第 二 个 账 
户 。 它 的 用 途 是 向 网 络 提供 以 太 币 。 用 户 可 以 用 自己 的 地 址 替换 它 。 


在 继续 下 一 步 操作 之 前 ， 创 建 另 一 个 文件 node.pwds， 在 其 中 放 入 所 创建 的 账户 的 密码 。 该 文件 将 补 验 证 器 用 来 解锁 账 
P, FAKIR, 


3. Ra 


现在 已 经 具备 各 种 条 件 启动 验证 节点 了 。 在 第 一 个 shell 窗 口中 ， 运 行 如 下 命令 以 启动 第 一 个 验证 节点 


parity  --chain spec.json -d ./validatorO0 --force-sealing --engine-signer 
"0x831647ec69be4ca44ea4bd1b9909debfbaaef55c" --port 30300 --jsonrpc-port 
8540 --ui-port 8180 --dapps-port 8080 --ws-port 8546 --jsonrpc-apis 
web3,eth,net,personal,parity,parity set,traces,rpc,parity accounts -- 
password "node.pwds" 


上 述 命令 的 工作 原理 如 下 : 
--chain 用 于 指定 规范 文件 的 路 径 。 

- -d 用 于 指定 数据 目 隶 。 
--force-sealing 用 于 确保 即使 没有 交易 也 产生 区 块 。 


- --engine-signef 用 于 指定 节点 签署 区 块 时 使 用 的 地 址 ， 即 验证 器 的 地 址 。 如 果 可 能 有 恶意 机 构 ， 则 推荐 用 --fotce-sealing， 这 
将 保证 正确 的 链 是 最 长 的 。 确 保 把 地 址 改 为 生成 的 那个 地 址 ， 即 在 这 个 shell 窗 口 生 成 的 地 址 。 
` --password Jf] T- 48 Z FAG SC 4T 
在 第 二 个 shell 窗 口中 ， 运 行 如 下 命令 以 启动 第 二 个 验证 节 
parity  --chain spec.json -d ./validator1 --force-sealing --engine-signer 
"0x12a6bda0d5f58538167b2efce5519e316863f9fd" --port 30301 --jsonrpc-port 
8541 --ui-port 8181 --dapps-port 8081 --ws-port 8547 --jsonrpc-apis 


web3,eth,net,personal,parity,parity set,traces,rpc,parity accounts -- 
password "/Users/narayanprusty/Desktop/node.pwds" 


确保 把 地 址 修改 为 生成 的 那个 地 址 ， 即 在 这 个 shell 窗 口 生 成 的 地 址 。 


最 后 需要 连接 两 个 节操 。 打 开 一 个 新 的 shell 窗 口 ， 运 行 如 下 命令 ，URL 会 连接 到 第 二 个 书 操 : 


curl --data 'í("jsonrpc":"2.0","method":"parity enode","params":[],"id":0}' 
-H "Content-Type: application/json" -X POST localhost:8541 


将 得 到 类 似 这 样 的 输出 : 


("jsonrpc":"2.0","result":"enode://7bac3c8cf914903904a408ecd71635966331990c 
5c9£7c7a291b531d5912ac3b52e8b174994b93cab1bf14118c2£24a16£75c49e83b93e0864e 
b099996eclaf9([::0.0.1.0]:30301","id":0) 


运行 如 下 命令 ， 把 URL 中 的 编码 URL 和 1P 地 址 修改 为 127.0.0.1: 


curl --data 
'("jsonrpc":"2.0", "method":"parity_addReservedPeer", "params": ["enode://7ba. 
."],"id":0)' -H "Content-Type: application/json" -X POST localhost: 8540 


得 到 如 下 输出 : 
i"3s40nrpo":"A2.0'."vG5sult';trud,"":4d":0) 


该 节点 应 当 表 示 操 作 人 台中 的 0/1/25 peers， 这 意味 着 它们 彼此 没有 连接 。 示 意图 如 下 : 


2017-84-19 00:29:59 Imported (0 txs, 0.00 Mgas, 0.57 ms, 8.56 KiB) 
2017-04-19 00:30:04 Imported (0 txs, 0.00 Mgas, 0.60 ms, 8.56 KiB) 
(2017-04-19 00:30:10 Imported (0 txs, 0.00 Mgas, @.51 ms, 0.56 KiB) 
2017-04-19 00:30:15 Imported (0 txs, 0.00 Mgas, 0.58 ms, 0.56 KiB) 
2017-04-19 00:30:17 Of 1/75 peers 309 KiB db 302 KiB chain ©@ bytes queue 17 KiB 
2017-04-19 00:30:19 Imported (08 txs, 8.80 Mgas, 8.49 ms, 8.56 KiB) 
2017-84-19 00:30:25 Imported (日 txs, 0.00 Mgas, 0.48 ms, 0.56 KiB) 
2017-04-19 00:30:29 Imported (0 txs, 0.00 Mgas, 8.51 ms, 80.56 KiB) 
2017-04-19 00:30:35 Imported (0 txs, 0.00 Mgas, 0.46 ms, 0.56 KiB) 
2017-04-19 00:30:40 Imported (0 txs, 0.00 Mgas, 8.65 ms, 80.56 KiB) 
2017-04-19 00:30:45 Imported (0 txs, 0.00 Mgas, 0.53 ms, 0.56 KiB) 
2017-04-19 00:30:47 Ə/ 1/25 peers 311 KiB db 302 KiB chain © bytes queue 17 KiB 
2017-04-19 88:38:49 Imported (0 txs, 8.80 Mgas, 8.47 ms, 8.56 KiB) 
2017-04-19 00:30:55 Imported (0 txs, 0.00 Mgas, 0.58 ms, 80.56 KiB) 
2017-04-19 80:30:59 Imported (0 txs, 0.800 Mgas, 0.53 ms, 80.56 KiB) 
2017-04-19 88:31:05 Imported (0 txs, 0.00 Mgas, 8.46 ms, 80.56 KiB) 
2017-04-19 00:31:10 Imported (0 txs, 0.00 Mgas, 0.53 ms, 0.56 KiB) 
2017-04-19 00:31:15 Imported (0 txs, 0.00 Mgas, @.53 ms, @.56 KiB) 


9.3.4 许可 和 隐私 


我 们 已 经 看 到 了 parity 是 如 何 解决 速度 和 安全 问题 的 。parity 目 前 并 不 提供 专门 的 许可 和 隐私 功能 。 让 我 们 看 看 如 何在 
parity 中 实现 许可 和 隐私 : 


1) 许可 。parity 网 络 可 以 配置 每 个 节点 的 服务 端 ， 只 人 允许 特定 的 IP 地 址 建立 连接 ， 由 此 实现 许可 ， 即 决定 谁 能 加 入 、 谁 不 
能 加 入 。 即 使 IP 地 址 没有 被 拦截 ， 为 了 连接 到 网 络 中 的 节点 ， 新 的 书 点 也 将 需要 一 个 enode 地 址 ， 朋 这 个 地 址 是 猜 不 到 的 。 所 以 
默认 parity 有 基本 保护 。 但 是 没有 强制 实施 保护 。 网 络 中 的 每 一 个 节点 需要 在 其 终端 关 注 此 事 。 可 以 通过 智能 合约 进行 类 似 许 
可 ， 即 决定 谁 能 创建 区 块 以 及 谁 不 能 创建 区 块 。 目 前 还 不 能 设 定 哪 种 交易 节点 可 以 友 送 。 


2) 号 份 隐私 。 通 过 允许 所 有 权 查 询 ， 有 办 法 实现 身份 隐私 。 在 设 定 所 有 权时 ， 所 有 者 需要 指定 一 个 非 确定 性 的 、 不 对 称 的 
加 密 公 钥 。 当 它 想 通 过 所 有 权 查 询 时 ， 将 提供 一 个 加 密 的 普通 文本 ,合约 对 其 解码 ， 并 查看 账户 是 否 是 所 有 者 。 合 约 应 当 确 保 不 
会 检查 同样 的 加 密 数 据 两 次 。 


3) 数据 隐私 。 如 果 只 是 使 用 区 块 链 存储 数据 ， 则 可 以 使 用 对 称 的 加 密 万 式 加 密 数据 并 存储 ， 还 可 以 与 科 人 共享 密 钥 。 但 是 
不 能 在 加 密 数据 上 进行 操作 ， 如 果 需 要 在 输入 数据 上 进行 操作 ， 同 时 还 想 要 保密 ， 则 各 方 需要 建立 一 个 完全 不 同 的 区 块 链 网 络 。 
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在 本 章 中 ， 我 们 学 习 了 patity 的 使 用 方法 、Auta 的 工作 原理 以 及 一 些 在 patity 中 实现 许可 和 保密 性 的 技巧 。 至 此 ， 读 者 应 具备 
了 用 区 块 链 创建 一 个 概念 证 明 (proof-of-concept) 联盟 的 能 力 。 读 者 可 以 继续 探索 其 他 创建 联盟 区 块 链 的 方式 ， 例 如 Hyperledger 


1.0 和 quorum。 目 前 ， 以 太 坊 官方 正在 努力 适用 于 联盟 ， 感 兴趣 的 读者 可 宅 切 关注 多 种 区 块 链 信 息 源 ， 以 学 习 新 知识 。 


